DataObject.GetFormats Methode

Definition

Namespace:: System.Windows

Assembly:: PresentationCore.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Gibt eine Liste von Formaten zurück, in denen die Daten in diesem Datenobjekt gespeichert sind oder in die konvertiert werden können.

Überlädt

Name	Beschreibung
GetFormats()	Gibt eine Liste von Formaten zurück, in denen die Daten in diesem Datenobjekt gespeichert sind oder in die konvertiert werden können.
GetFormats(Boolean)	Gibt eine Liste von Formaten zurück, in denen die Daten in diesem Datenobjekt gespeichert werden. Ein `Boolean` Kennzeichen gibt an, ob auch Formate einbezogen werden sollen, in die die Daten automatisch konvertiert werden können.

GetFormats()

Gibt eine Liste von Formaten zurück, in denen die Daten in diesem Datenobjekt gespeichert sind oder in die konvertiert werden können.

public:
 virtual cli::array <System::String ^> ^ GetFormats();

public string[] GetFormats();

abstract member GetFormats : unit -> string[]
override this.GetFormats : unit -> string[]

Public Function GetFormats () As String()

Gibt zurück

String[]

Ein Array von Zeichenfolgen, wobei jede Zeichenfolge den Namen eines Formats angibt, das dieses Datenobjekt unterstützt.

Implementiert

GetFormats()

Beispiele

Im folgenden Beispiel wird diese Methode verwendet, um ein Array von Zeichenfolgen abzurufen, das alle Datenformate angibt, die in einem Datenobjekt verfügbar sind (systemeigene und autokonvertierbare).

DataObject dataObject = new DataObject("Some string data to store...");

// Get an array of strings, each string denoting a data format
// that is available in the data object.  This overload of GetDataFormats
// returns all available data formats, native and auto-convertible.
string[] dataFormats = dataObject.GetFormats();

// Get the number of data formats present in the data object, including both
// auto-convertible and native data formats.
int numberOfDataFormats = dataFormats.Length;

// To enumerate the resulting array of data formats, and take some action when
// a particular data format is found, use a code structure similar to the following.
foreach (string dataFormat in dataFormats)
{
    if (dataFormat == DataFormats.Text)
    {
        // Take some action if/when data in the Text data format is found.
        break;
    }
    else if(dataFormat == DataFormats.StringFormat)
    {
        // Take some action if/when data in the string data format is found.
        break;
    }
}

Dim dataObject As New DataObject("Some string data to store...")

' Get an array of strings, each string denoting a data format
' that is available in the data object.  This overload of GetDataFormats
' returns all available data formats, native and auto-convertible.
Dim dataFormats() As String = dataObject.GetFormats()

' Get the number of data formats present in the data object, including both
' auto-convertible and native data formats.
Dim numberOfDataFormats As Integer = dataFormats.Length

' To enumerate the resulting array of data formats, and take some action when
' a particular data format is found, use a code structure similar to the following.
For Each dataFormat As String In dataFormats
    If dataFormat = System.Windows.DataFormats.Text Then
        ' Take some action if/when data in the Text data format is found.
        Exit For
    ElseIf dataFormat = System.Windows.DataFormats.StringFormat Then
        ' Take some action if/when data in the string data format is found.
        Exit For
    End If
Next dataFormat

Hinweise

Eine Reihe vordefinierter Datenformate finden Sie in der DataFormats Klasse.

Gilt für:

GetFormats(Boolean)

Gibt eine Liste von Formaten zurück, in denen die Daten in diesem Datenobjekt gespeichert werden. Ein Boolean Kennzeichen gibt an, ob auch Formate einbezogen werden sollen, in die die Daten automatisch konvertiert werden können.

public:
 virtual cli::array <System::String ^> ^ GetFormats(bool autoConvert);

public string[] GetFormats(bool autoConvert);

abstract member GetFormats : bool -> string[]
override this.GetFormats : bool -> string[]

Public Function GetFormats (autoConvert As Boolean) As String()

Parameter

autoConvert: Boolean

true um alle Formate abzurufen, in denen die Daten in diesem Datenobjekt gespeichert werden oder in die konvertiert werden können; false um nur Formate abzurufen, in denen die Daten in diesem Datenobjekt gespeichert werden.

Gibt zurück

String[]

Ein Array von Zeichenfolgen, wobei jede Zeichenfolge den Namen eines Formats angibt, das von diesem Datenobjekt unterstützt wird.

Implementiert

GetFormats(Boolean)

Beispiele

Im folgenden Beispiel wird diese Methode verwendet, um ein Array von Zeichenfolgen abzurufen, das nur Datenformate angibt, die in einem Datenobjekt verfügbar sind (autokonvertierbare Datenformate werden gefiltert).

DataObject dataObject = new DataObject("Some string data to store...");

// Get an array of strings, each string denoting a data format
// that is available in the data object.  This overload of GetDataFormats
// accepts a Boolean parameter inidcating whether to include auto-convertible
// data formats, or only return native data formats.
string[] dataFormats = dataObject.GetFormats(false /* Include auto-convertible? */);

// Get the number of native data formats present in the data object.
int numberOfDataFormats = dataFormats.Length;

// To enumerate the resulting array of data formats, and take some action when
// a particular data format is found, use a code structure similar to the following.
foreach (string dataFormat in dataFormats)
{
    if (dataFormat == DataFormats.Text)
    {
        // Take some action if/when data in the Text data format is found.
        break;
    }
}

Dim dataObject As New DataObject("Some string data to store...")

' Get an array of strings, each string denoting a data format
' that is available in the data object.  This overload of GetDataFormats
' accepts a Boolean parameter inidcating whether to include auto-convertible
' data formats, or only return native data formats.
Dim dataFormats() As String = dataObject.GetFormats(False) ' Include auto-convertible? 

' Get the number of native data formats present in the data object.
Dim numberOfDataFormats As Integer = dataFormats.Length

' To enumerate the resulting array of data formats, and take some action when
' a particular data format is found, use a code structure similar to the following.
For Each dataFormat As String In dataFormats
    If dataFormat = System.Windows.DataFormats.Text Then
        ' Take some action if/when data in the Text data format is found.
        Exit For
    End If
Next dataFormat

Hinweise

Eine Reihe vordefinierter Datenformate finden Sie in der DataFormats Klasse.

Gilt für:

Feedback

War diese Seite hilfreich?