DataObject.GetData Methode
Definition
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.
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.