DataObject.GetData Metódus
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Megadott adatformátumban adja vissza az adatokat.
Túlterhelések
| Name | Description |
|---|---|
| GetData(String) |
Sztring által megadott formátumban adja vissza az adatokat. |
| GetData(Type) |
Egy objektum által Type megadott formátumú adatobjektumot ad vissza. |
| GetData(String, Boolean) |
Adott formátumú adatobjektumot ad vissza, opcionálisan átalakítva az adatokat a megadott formátumra. |
GetData(String)
Sztring által megadott formátumban adja vissza az adatokat.
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
Paraméterek
- format
- String
Az adatok formátumát meghatározó sztring. Előre definiált adatformátumokat az DataFormats osztályban talál.
Válaszok
Egy objektum, amely a megadott formátumban tartalmazza az adatokat, vagy null ha az adatok nem érhetők el a megadott formátumban.
Megvalósítás
Kivételek
format az null.
Példák
Az alábbi példa ezt a módszert használja először annak ellenőrzésére, hogy elérhető-e egy megadott adatformátum (natív vagy automatikus konvertálással); ha a megadott formátum elérhető, a példa a metódus használatával kéri le az GetData(String) adatokat.
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
Az alábbi példakód a GetDataPresent(String, Boolean) metódus használatával először ellenőrzi, hogy egy megadott adatformátum natívan elérhető-e (az automatikusan konvertálható adatformátumok szűrve vannak); ha a megadott formátum elérhető, a példa a metódus használatával kéri le az GetData(String) adatokat.
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
Lásd még
A következőre érvényes:
GetData(Type)
Egy objektum által Type megadott formátumú adatobjektumot ad vissza.
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
Paraméterek
- format
- Type
Az Type adatok formátumát meghatározó a formátum. Előre definiált adatformátumokat az DataFormats osztályban talál.
Válaszok
Adatobjektum a megadott formátumban lévő adatokkal, vagy null ha az adatok nem érhetők el a megadott formátumban.
Megvalósítás
Kivételek
format az null.
Lásd még
A következőre érvényes:
GetData(String, Boolean)
Adott formátumú adatobjektumot ad vissza, opcionálisan átalakítva az adatokat a megadott formátumra.
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
Paraméterek
- format
- String
Az adatok formátumát meghatározó sztring. Előre definiált adatformátumokat az DataFormats osztályban talál.
- autoConvert
- Boolean
true az adatok automatikus konvertálásának megkísérlése a megadott formátumra; false adatformátum-átalakítás nélkül.
Válaszok
Adatobjektum a megadott formátumban lévő adatokkal, vagy null ha az adatok nem érhetők el a megadott formátumban.
Ha a autoConvert paraméter aztrue, és az adatok nem konvertálhatók a megadott formátumra, vagy ha az automatikus átalakítás le van tiltva (a paraméter beállításávalSetData(String, Object, Boolean)autoConvert), ez a false metódus ad visszanull.
Megvalósítás
Kivételek
format
null értékű.