DataObject.GetData Metoda

Definice

Obor názvů:

System.Windows

Sestavení:

PresentationCore.dll

Vrátí data v zadaném formátu dat.

Přetížení

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);

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. Pro sadu předdefinovaných datových formátů se podívejte na DataFormats třídu.

Návraty

Object

Objekt obsahující data v zadaném formátu nebo null pokud data nejsou v zadaném formátu k dispozici.

Implementuje

GetData(String)

Výjimky

ArgumentNullException

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 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;
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í ukázkový kód používá metodu GetDataPresent(String, Boolean) k první kontrole, jestli je nativně k dispozici zadaný formát dat (filtrují se automaticky konvertibilní datové formáty); 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é

• Načtení ukázky vyřazeného souboru

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);

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 datových formátů najdete ve DataFormats třídě.

Návraty

Object

Datový objekt s daty v zadaném formátu nebo null pokud data nejsou v zadaném formátu k dispozici.

Implementuje

GetData(Type)

Výjimky

ArgumentNullException

format je null.

Viz také

• Načtení ukázky vyřazeného souboru

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);

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 datových formátů najdete ve DataFormats třídě.

autoConvert

Boolean

true se pokusí automaticky převést data do zadaného formátu; false bez převodu formátu dat.

Návraty

Object

Datový objekt s daty v zadaném formátu nebo null pokud data nejsou v zadaném formátu k dispozici.

Pokud je autoConvert true parametr a data nelze převést na zadaný formát, 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

GetData(String, Boolean)

Výjimky

ArgumentNullException

format je null.

Viz také

• Načtení ukázky vyřazeného souboru