DataObject.GetDataPresent 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.

Bestimmt, ob die Daten in einem angegebenen Format verfügbar oder in ein angegebenes Format konvertiert werden können.

Überlädt

Name	Beschreibung
GetDataPresent(String)	Bestimmt, ob die Daten in einem durch eine Zeichenfolge angegebenen Format verfügbar sind oder in das konvertiert werden können.
GetDataPresent(Type)	Bestimmt, ob die Daten in einem durch ein Objekt angegebenen Format verfügbar sind oder in das Type konvertiert werden können.
GetDataPresent(String, Boolean)	Bestimmt, ob die Daten in einem angegebenen Format verfügbar oder in ein angegebenes Format konvertiert werden können. Ein `Boolean` Flag gibt an, ob überprüft werden soll, ob die Daten in das angegebene Format konvertiert werden können, wenn sie in diesem Format nicht verfügbar ist.

Hinweise

Rufen Sie GetDataPresent auf, um zu bestimmen, ob ein Format in diesem Datenobjekt vor dem Aufrufen GetDataverfügbar ist. Rufen Sie GetFormats auf, um eine Liste aller Formate abzurufen, die in diesem Datenobjekt verfügbar sind.

GetDataPresent(String)

Bestimmt, ob die Daten in einem durch eine Zeichenfolge angegebenen Format verfügbar sind oder in das konvertiert werden können.

public:
 virtual bool GetDataPresent(System::String ^ format);

public bool GetDataPresent(string format);

abstract member GetDataPresent : string -> bool
override this.GetDataPresent : string -> bool

Public Function GetDataPresent (format As String) As Boolean

Parameter

format: String

Eine Zeichenfolge, die das Format für die Daten angibt. Eine Reihe vordefinierter Datenformate finden Sie in der DataFormats Klasse.

Gibt zurück

Boolean

truewenn sich die Daten in dem angegebenen Format befindet oder in das angegebene Format konvertiert werden können; andernfalls . false

Implementiert

GetDataPresent(String)

Ausnahmen

ArgumentNullException

format ist null.

Beispiele

Im folgenden Beispiel wird diese Methode verwendet, um das Vorhandensein eines bestimmten Datenformats durch Deskriptorzeichenfolge abzufragen.

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

// Query for the presence of Text data in the data object, by a data format descriptor string.
// In this overload of GetDataPresent, the method will return true both for native data formats
// and when the data can automatically be converted to the specifed format.

// In this case, string data is present natively, so GetDataPresent returns "true".
string textData = null;
if (dataObject.GetDataPresent(DataFormats.StringFormat))
{
    textData = dataObject.GetData(DataFormats.StringFormat) as string;
}

// In this case, the Text data in the data object can be autoconverted to 
// Unicode text, so GetDataPresent returns "true".
byte[] unicodeData = null;
if (dataObject.GetDataPresent(DataFormats.UnicodeText))
{
    unicodeData = dataObject.GetData(DataFormats.UnicodeText) as byte[];
}

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

' Query for the presence of Text data in the data object, by a data format descriptor string.
' In this overload of GetDataPresent, the method will return true both for native data formats
' and when the data can automatically be converted to the specifed format.

' In this case, string data is present natively, so GetDataPresent returns "true".
Dim textData As String = Nothing
If dataObject.GetDataPresent(DataFormats.StringFormat) Then
    textData = TryCast(dataObject.GetData(DataFormats.StringFormat), String)
End If

' In this case, the Text data in the data object can be autoconverted to 
' Unicode text, so GetDataPresent returns "true".
Dim unicodeData() As Byte = Nothing
If dataObject.GetDataPresent(DataFormats.UnicodeText) Then
    unicodeData = TryCast(dataObject.GetData(DataFormats.UnicodeText), Byte())
End If

Hinweise

Weitere Informationen

Laden eines Abgelegten Dateibeispiels

Gilt für:

GetDataPresent(Type)

Bestimmt, ob die Daten in einem durch ein Objekt angegebenen Format verfügbar sind oder in das Type konvertiert werden können.

public:
 virtual bool GetDataPresent(Type ^ format);

public bool GetDataPresent(Type format);

abstract member GetDataPresent : Type -> bool
override this.GetDataPresent : Type -> bool

Public Function GetDataPresent (format As Type) As Boolean

Parameter

format: Type

Ein Type Wert, der das zu überprüfende Datenformat angibt. F oder eine Reihe vordefinierter Datenformate finden Sie in der DataFormats Klasse.

Gibt zurück

Boolean

truewenn sich die Daten in dem angegebenen Format befindet oder in das angegebene Format konvertiert werden können; andernfalls . false

Implementiert

GetDataPresent(Type)

Ausnahmen

ArgumentNullException

format ist null.

Beispiele

Im folgenden Beispiel wird diese Methode verwendet, um das Vorhandensein eines bestimmten Datenformats nach Typ abzufragen.

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

// Query for the presence of String data in the data object, by type.  In this overload 
// of GetDataPresent, the method will return true both for native data formats
// and when the data can automatically be converted to the specifed format.

// In this case, the Text data present in the data object can be autoconverted
// to type string (also represented by DataFormats.String), so GetDataPresent returns "true".
string stringData = null;
if (dataObject.GetDataPresent(typeof(string)))
{
    stringData = dataObject.GetData(DataFormats.Text) as string;
}

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

' Query for the presence of String data in the data object, by type.  In this overload 
' of GetDataPresent, the method will return true both for native data formats
' and when the data can automatically be converted to the specifed format.

' In this case, the Text data present in the data object can be autoconverted
' to type string (also represented by DataFormats.String), so GetDataPresent returns "true".
Dim stringData As String = Nothing
If dataObject.GetDataPresent(GetType(String)) Then
    stringData = TryCast(dataObject.GetData(DataFormats.Text), String)
End If

Hinweise

Weitere Informationen

Laden eines Abgelegten Dateibeispiels

Gilt für:

GetDataPresent(String, Boolean)

Bestimmt, ob die Daten in einem angegebenen Format verfügbar oder in ein angegebenes Format konvertiert werden können. Ein Boolean Flag gibt an, ob überprüft werden soll, ob die Daten in das angegebene Format konvertiert werden können, wenn sie in diesem Format nicht verfügbar ist.

public:
 virtual bool GetDataPresent(System::String ^ format, bool autoConvert);

public bool GetDataPresent(string format, bool autoConvert);

abstract member GetDataPresent : string * bool -> bool
override this.GetDataPresent : string * bool -> bool

Public Function GetDataPresent (format As String, autoConvert As Boolean) As Boolean

Parameter

format: String

Eine Zeichenfolge, die das zu überprüfende Datenformat angibt. Eine Reihe vordefinierter Datenformate finden Sie in der DataFormats Klasse.

autoConvert: Boolean

false nur auf das angegebene Format zu überprüfen; true um auch zu überprüfen, ob in diesem Datenobjekt gespeicherte Daten in das angegebene Format konvertiert werden können.

Gibt zurück

Boolean

truewenn sich die Daten in dem angegebenen Format befindet oder in das angegebene Format konvertiert werden können; andernfalls . false

Implementiert

GetDataPresent(String, Boolean)

Ausnahmen

ArgumentNullException

format ist null.

Beispiele

Im folgenden Beispiel wird diese Methode verwendet, um Daten anhand der Beschreibungszeichenfolge abzufragen, und gibt an, wie automatisch konvertierbare Datenformate behandelt werden.

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

// Query for the presence of Text data in the data object, by data format descriptor string,
// and specifying whether auto-convertible data formats are acceptable.  

// In this case, Text data is present natively, so GetDataPresent returns "true".
string textData = null;
if (dataObject.GetDataPresent(DataFormats.Text, false /* Auto-convert? */))
{
    textData = dataObject.GetData(DataFormats.Text) as string;
}

// In this case, the Text data in the data object can be autoconverted to 
// Unicode text, but it is not available natively, so GetDataPresent returns "false".
byte[] unicodeData = null;
if (dataObject.GetDataPresent(DataFormats.UnicodeText, false /* Auto-convert? */))
{
    unicodeData = dataObject.GetData(DataFormats.UnicodeText) as byte[];
}

// In this case, the Text data in the data object can be autoconverted to 
// Unicode text, so GetDataPresent returns "true".
if (dataObject.GetDataPresent(DataFormats.UnicodeText, true /* Auto-convert? */))
{
    unicodeData = dataObject.GetData(DataFormats.UnicodeText) as byte[];
}

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

' Query for the presence of Text data in the data object, by data format descriptor string,
' and specifying whether auto-convertible data formats are acceptable.  

' In this case, Text data is present natively, so GetDataPresent returns "true".
Dim textData As String = Nothing
If dataObject.GetDataPresent(DataFormats.Text, False) Then ' Auto-convert? 
    textData = TryCast(dataObject.GetData(DataFormats.Text), String)
End If

' In this case, the Text data in the data object can be autoconverted to 
' Unicode text, but it is not available natively, so GetDataPresent returns "false".
Dim unicodeData() As Byte = Nothing
If dataObject.GetDataPresent(DataFormats.UnicodeText, False) Then ' Auto-convert? 
    unicodeData = TryCast(dataObject.GetData(DataFormats.UnicodeText), Byte())
End If

' In this case, the Text data in the data object can be autoconverted to 
' Unicode text, so GetDataPresent returns "true".
If dataObject.GetDataPresent(DataFormats.UnicodeText, True) Then ' Auto-convert? 
    unicodeData = TryCast(dataObject.GetData(DataFormats.UnicodeText), Byte())
End If

Hinweise

Weitere Informationen

Laden eines Abgelegten Dateibeispiels

Gilt für:

Feedback

War diese Seite hilfreich?

Freigeben über

DataObject.GetDataPresent Methode

Definition

Überlädt

Hinweise

GetDataPresent(String)

Parameter

Gibt zurück

Implementiert

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

GetDataPresent(Type)

Parameter

Gibt zurück

Implementiert

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

GetDataPresent(String, Boolean)

Parameter

Gibt zurück

Implementiert

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Feedback