DataObject.GetData Methode

public:
 virtual System::Object ^ GetData(System::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

Gibt zurück

Object

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

Implementiert

Ausnahmen

Beispiele

Im folgenden Beispiel wird diese Methode verwendet, um zuerst zu überprüfen, ob ein angegebenes Datenformat verfügbar ist (systemeigene 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 Methode verwendet, um zu überprüfen, ob ein angegebenes Datenformat systemeigenen verfügbar ist (automatisch wandelbare Datenformate werden gefiltert); wenn das angegebene Format verfügbar ist, ruft das Beispiel die GetDataPresent(String, Boolean) 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

Siehe auch

• Laden eines Abgelassenen Dateibeispiels

public:
 virtual System::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

Gibt zurück

Object

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

Implementiert

Ausnahmen

Siehe auch

• Laden eines Abgelassenen Dateibeispiels

public:
 virtual System::Object ^ GetData(System::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

Gibt zurück

Object

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

Wenn der autoConvert-Parameter true ist und die Daten nicht in das angegebene Format konvertiert werden können oder die automatische Konvertierung deaktiviert ist (durch Aufrufen von SetData(String, Object, Boolean) mit einem auf false festgelegten autoConvert-Parameter), gibt diese Methode null zurück.

Implementiert

Ausnahmen

Siehe auch

• Laden eines Abgelassenen Dateibeispiels