DataObject.GetData Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Vrátí data v zadaném formátu dat.
Přetížení
| Name | Description |
|---|---|
| GetData(String) |
Vrátí data ve formátu určeném řetězcem. |
| GetData(Type) |
Vrátí datový objekt ve formátu určeném objektem Type . |
| GetData(String, Boolean) |
Vrátí datový objekt v zadaném formátu, volitelně převede data do zadaného formátu. |
GetData(String)
Vrátí data ve formátu určeném řetězcem.
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
Parametry
- format
- String
Řetězec, který určuje formát dat. Sadu předdefinovaných formátů dat najdete v DataFormats této třídě.
Návraty
Objekt obsahující data v zadaném formátu nebo null pokud data nejsou v zadaném formátu k dispozici.
Implementuje
Výjimky
format je null.
Příklady
Následující příklad používá tuto metodu k první kontrole, zda je zadaný formát dat k dispozici (nativně nebo pomocí automatického převodu); pokud je k dispozici zadaný formát, příklad načte data pomocí GetData(String) metody.
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
Následující příklad kódu používá metodu GetDataPresent(String, Boolean) k první kontrole, zda je zadaný formát dat k dispozici nativně (automaticky konvertibilní formáty dat jsou filtrovány); pokud je zadaný formát k dispozici, příklad načte data pomocí GetData(String) metody.
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
Viz také
Platí pro
GetData(Type)
Vrátí datový objekt ve formátu určeném objektem Type .
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
Parametry
- format
- Type
A Type , který určuje formát dat. Sadu předdefinovaných formátů dat najdete v DataFormats této třídě.
Návraty
Datový objekt s daty v zadaném formátu nebo null pokud data nejsou v zadaném formátu k dispozici.
Implementuje
Výjimky
format je null.
Viz také
Platí pro
GetData(String, Boolean)
Vrátí datový objekt v zadaném formátu, volitelně převede data do zadaného formátu.
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
Parametry
- format
- String
Řetězec, který určuje formát dat. Sadu předdefinovaných formátů dat najdete v DataFormats této třídě.
- autoConvert
- Boolean
true automaticky převést data do zadaného formátu; false pro žádný převod formátu dat.
Návraty
Datový objekt s daty v zadaném formátu nebo null pokud data nejsou v zadaném formátu k dispozici.
autoConvert Pokud je true parametr a data nelze převést do zadaného formátu nebo pokud je automatický převod zakázán (voláním SetData(String, Object, Boolean) s autoConvert parametrem nastaveným na false), tato metoda vrátí null.
Implementuje
Výjimky
format je null.