DataObject.GetDataPresent Methode

Definition

Namespace:

System.Windows

Assembly:

PresentationCore.dll

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

Überlädt

GetDataPresent(String)	Bestimmt, ob die Daten in einem durch eine Zeichenfolge angegebenen Format verfügbar sind oder in dieses Format konvertiert werden können.
GetDataPresent(Type)	Bestimmt, ob die Daten in einem durch ein Type-Objekt angegebenen Format verfügbar sind oder in dieses Format konvertiert werden können.
GetDataPresent(String, Boolean)	Bestimmt, ob die Daten in einem angegebenen Format verfügbar sind oder in dieses 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 sind.

Hinweise

Rufen Sie GetDataPresent auf, um zu ermitteln, ob ein Format in diesem Datenobjekt verfügbar ist, bevor Sie aufrufen GetData. Rufen Sie GetFormats eine Liste aller Formate auf, 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 dieses Format 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. Ein Satz vordefinierter Datenformate finden Sie in der DataFormats-Klasse.

Gibt zurück

Boolean

true, wenn die Daten das angegebene Format aufweisen oder in dieses konvertiert werden können, andernfalls false.

Implementiert

GetDataPresent(String)

Ausnahmen

ArgumentNullException

format ist null.

Beispiele

Im folgenden Beispiel wird diese Methode verwendet, um die Anwesenheit eines bestimmten Datenformats durch Descriptorzeichenfolge 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

Rufen Sie GetDataPresent auf, um zu ermitteln, ob ein Format in diesem Datenobjekt verfügbar ist, bevor Sie aufrufen GetData. Rufen Sie GetFormats eine Liste aller Formate auf, die in diesem Datenobjekt verfügbar sind.

Siehe auch

• Laden eines Abgelassenen Dateibeispiels

GetDataPresent(Type)

Bestimmt, ob die Daten in einem durch ein Type-Objekt angegebenen Format verfügbar sind oder in dieses Format 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, der das zu überprüfende Datenformat angibt. Einen Satz vordefinierter Datenformate finden Sie in der DataFormats-Klasse.

Gibt zurück

Boolean

true, wenn die Daten das angegebene Format aufweisen oder in dieses konvertiert werden können, andernfalls false.

Implementiert

GetDataPresent(Type)

Ausnahmen

ArgumentNullException

format ist null.

Beispiele

Im folgenden Beispiel wird diese Methode verwendet, um die Anwesenheit 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

Rufen Sie GetDataPresent auf, um zu ermitteln, ob ein Format in diesem Datenobjekt verfügbar ist, bevor Sie aufrufen GetData. Rufen Sie GetFormats eine Liste aller Formate auf, die in diesem Datenobjekt verfügbar sind.

Siehe auch

• Laden eines Abgelassenen Dateibeispiels

GetDataPresent(String, Boolean)

Bestimmt, ob die Daten in einem angegebenen Format verfügbar sind oder in dieses 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 sind.

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. Ein Satz vordefinierter Datenformate finden Sie in der DataFormats-Klasse.

autoConvert

Boolean

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

Gibt zurück

Boolean

true, wenn die Daten das angegebene Format aufweisen oder in dieses 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 nach Daten durch Descriptorzeichenfolge zu abfragen und angibt, wie Sie automatisch konvertierbare Datenformate behandeln.

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

Rufen Sie GetDataPresent auf, um zu ermitteln, ob ein Format in diesem Datenobjekt verfügbar ist, bevor Sie aufrufen GetData. Rufen Sie GetFormats eine Liste aller Formate auf, die in diesem Datenobjekt verfügbar sind.

Siehe auch

• Laden eines Abgelassenen Dateibeispiels