Freigeben über


DataObject.GetData Methode

Definition

Gibt Daten in einem angegebenen Datenformat zurück.

Überlädt

Name Beschreibung
GetData(String)

Gibt Daten in einem format zurück, das durch eine Zeichenfolge angegeben wird.

GetData(Type)

Gibt ein Datenobjekt in einem format zurück, das durch ein Type Objekt angegeben wird.

GetData(String, Boolean)

Gibt ein Datenobjekt in einem angegebenen Format zurück, optional werden die Daten in das angegebene Format konvertiert.

GetData(String)

Gibt Daten in einem format zurück, das durch eine Zeichenfolge angegeben wird.

public:
 virtual System::Object ^ GetData(System::String ^ format);
public object GetData(string format);
public object? GetData(string format);
abstract member GetData : string -> obj
override this.GetData : string -> obj
Public Function GetData (format As String) As Object

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

Ein Objekt, das die Daten im angegebenen Format enthält oder null wenn die Daten im angegebenen Format nicht verfügbar sind.

Implementiert

Ausnahmen

format ist null.

Beispiele

Im folgenden Beispiel wird diese Methode verwendet, um zuerst zu überprüfen, ob ein angegebenes Datenformat verfügbar ist (nativ oder durch automatische Konvertierung); Wenn das angegebene Format verfügbar ist, ruft das Beispiel die Daten mithilfe der GetData(String) Methode ab.

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

string desiredFormat = DataFormats.UnicodeText;
byte[] data = null;

// Use the GetDataPresent method to check for the presence of a desired data format.
// This particular overload of GetDataPresent looks for both native and auto-convertible 
// data formats.
if (dataObject.GetDataPresent(desiredFormat))
{
    // If the desired data format is present, use one of the GetData methods to retrieve the
    // data from the data object.
    data = dataObject.GetData(desiredFormat) as byte[];
}
Dim dataObject As New DataObject("Some string data to store...")

Dim desiredFormat As String = DataFormats.UnicodeText
Dim data() As Byte = Nothing

' Use the GetDataPresent method to check for the presence of a desired data format.
' This particular overload of GetDataPresent looks for both native and auto-convertible 
' data formats.
If dataObject.GetDataPresent(desiredFormat) Then
    ' If the desired data format is present, use one of the GetData methods to retrieve the
    ' data from the data object.
    data = TryCast(dataObject.GetData(desiredFormat), Byte())
End If

Im folgenden Beispielcode wird die GetDataPresent(String, Boolean) Methode verwendet, um zuerst zu überprüfen, ob ein angegebenes Datenformat nativ verfügbar ist (automatisch konvertierbare Datenformate werden gefiltert). Wenn das angegebene Format verfügbar ist, ruft das Beispiel die Daten mithilfe der GetData(String) Methode ab.

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

string desiredFormat = DataFormats.UnicodeText;
bool noAutoConvert = false;
byte[] data = null;

// Use the GetDataPresent method to check for the presence of a desired data format.
// The autoconvert parameter is set to false to filter out auto-convertible data formats,
// returning true only if the specified data format is available natively.
if (dataObject.GetDataPresent(desiredFormat, noAutoConvert))
{
    // If the desired data format is present, use one of the GetData methods to retrieve the
    // data from the data object.
    data = dataObject.GetData(desiredFormat) as byte[];
}
Dim dataObject As New DataObject("Some string data to store...")

Dim desiredFormat As String = DataFormats.UnicodeText
Dim noAutoConvert As Boolean = False
Dim data() As Byte = Nothing

' Use the GetDataPresent method to check for the presence of a desired data format.
' The autoconvert parameter is set to false to filter out auto-convertible data formats,
' returning true only if the specified data format is available natively.
If dataObject.GetDataPresent(desiredFormat, noAutoConvert) Then
    ' If the desired data format is present, use one of the GetData methods to retrieve the
    ' data from the data object.
    data = TryCast(dataObject.GetData(desiredFormat), Byte())
End If

Weitere Informationen

Gilt für:

GetData(Type)

Gibt ein Datenobjekt in einem format zurück, das durch ein Type Objekt angegeben wird.

public:
 virtual System::Object ^ GetData(Type ^ format);
public object GetData(Type format);
public object? GetData(Type format);
abstract member GetData : Type -> obj
override this.GetData : Type -> obj
Public Function GetData (format As Type) As Object

Parameter

format
Type

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

Gibt zurück

Ein Datenobjekt mit den Daten im angegebenen Format oder null wenn die Daten im angegebenen Format nicht verfügbar sind.

Implementiert

Ausnahmen

format ist null.

Weitere Informationen

Gilt für:

GetData(String, Boolean)

Gibt ein Datenobjekt in einem angegebenen Format zurück, optional werden die Daten in das angegebene Format konvertiert.

public:
 virtual System::Object ^ GetData(System::String ^ format, bool autoConvert);
public object GetData(string format, bool autoConvert);
public object? GetData(string format, bool autoConvert);
abstract member GetData : string * bool -> obj
override this.GetData : string * bool -> obj
Public Function GetData (format As String, autoConvert As Boolean) As Object

Parameter

format
String

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

autoConvert
Boolean

true um zu versuchen, die Daten automatisch in das angegebene Format zu konvertieren; false für keine Datenformatkonvertierung.

Gibt zurück

Ein Datenobjekt mit den Daten im angegebenen Format oder null wenn die Daten im angegebenen Format nicht verfügbar sind.

Wenn der autoConvert Parameter ist true und die Daten nicht in das angegebene Format konvertiert werden können oder wenn die automatische Konvertierung deaktiviert ist (durch Aufrufen SetData(String, Object, Boolean) des autoConvert parameters set to false), gibt diese Methode zurück null.

Implementiert

Ausnahmen

format ist NULL.

Weitere Informationen

Gilt für: