DataObject.GetData DataObject.GetData DataObject.GetData DataObject.GetData Method

Definition

Gibt Daten in einem angegebenen Datenformat zurück.Returns data in a specified data format.

Überlädt

GetData(String) GetData(String) GetData(String) GetData(String)

Gibt Daten in einem durch eine Zeichenfolge angegebenen Format zurück.Returns data in a format specified by a string.

GetData(Type) GetData(Type) GetData(Type) GetData(Type)

Gibt ein Datenobjekt in einem von einem Type-Objekt angegebenen Format zurück.Returns a data object in a format specified by a Type object.

GetData(String, Boolean) GetData(String, Boolean) GetData(String, Boolean) GetData(String, Boolean)

Gibt ein Datenobjekt in einem angegebenen Format zurück und konvertiert die Daten optional in das angegebene Format.Returns a data object in a specified format, optionally converting the data to the specified format.

GetData(String) GetData(String) GetData(String) GetData(String)

Gibt Daten in einem durch eine Zeichenfolge angegebenen Format zurück.Returns data in a format specified by a string.

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

format
String String String String

Eine Zeichenfolge, die das Format für die Daten angibt.A string that specifies the format for the data. Einen Satz vordefinierter Datenformate finden Sie in der DataFormats-Klasse.For a set of predefined data formats, see the DataFormats class.

Gibt zurück

Ein Objekt, das die Daten im angegebenen Format enthält, oder null, wenn die Daten in diesem Format nicht verfügbar sind.An object that contains the data in the specified format, or null if the data is unavailable in the specified format.

Implementiert

Ausnahmen

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.The following example uses this method to first check whether a specified data format is available (natively or by auto-convert); if the specified format is available, the example retrieves the data by using the GetData(String) method.

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 System intern 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.The following example code uses the GetDataPresent(String, Boolean) method to first check if a specified data format is available natively (auto-convertible data formats are filtered); if the specified format is available, the example retrieves the data by using the GetData(String) method.

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

GetData(Type) GetData(Type) GetData(Type) GetData(Type)

Gibt ein Datenobjekt in einem von einem Type-Objekt angegebenen Format zurück.Returns a data object in a format specified by a Type object.

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

format
Type Type Type Type

Ein Type, der das Format für die Daten angibt.A Type that specifies the format for the data. Einen Satz vordefinierter Datenformate finden Sie in der DataFormats-Klasse.For a set of predefined data formats, see the DataFormats class.

Gibt zurück

Ein Datenobjekt mit Daten im angegebenen Format oder null, wenn die Daten in diesem Format nicht verfügbar sind.A data object with the data in the specified format, or null if the data is unavailable in the specified format.

Implementiert

Ausnahmen

Siehe auch

GetData(String, Boolean) GetData(String, Boolean) GetData(String, Boolean) GetData(String, Boolean)

Gibt ein Datenobjekt in einem angegebenen Format zurück und konvertiert die Daten optional in das angegebene Format.Returns a data object in a specified format, optionally converting the data to the specified format.

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

format
String String String String

Eine Zeichenfolge, die das Format für die Daten angibt.A string that specifies the format for the data. Einen Satz vordefinierter Datenformate finden Sie in der DataFormats-Klasse.For a set of predefined data formats, see the DataFormats class.

autoConvert
Boolean Boolean Boolean Boolean

true, um zu versuchen, die Daten automatisch in das angegebene Format zu konvertieren, false, wenn keine Datenformatkonvertierung ausgeführt werden soll.true to attempt to automatically convert the data to the specified format; false for no data format conversion.

Gibt zurück

Ein Datenobjekt mit Daten im angegebenen Format oder null, wenn die Daten in diesem Format nicht verfügbar sind.A data object with the data in the specified format, or null if the data is unavailable in the specified format.

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.If the autoConvert parameter is true and the data cannot be converted to the specified format, or if automatic conversion is disabled (by calling SetData(String, Object, Boolean) with the autoConvert parameter set to false), this method returns null.

Implementiert

Ausnahmen

Siehe auch

Gilt für: