Udostępnij za pośrednictwem


DataObject.GetData Metoda

Definicja

Zwraca dane w określonym formacie danych.

Przeciążenia

GetData(String)

Zwraca dane w formacie określonym przez ciąg.

GetData(Type)

Zwraca obiekt danych w formacie określonym przez Type obiekt.

GetData(String, Boolean)

Zwraca obiekt danych w określonym formacie, opcjonalnie konwertując dane na określony format.

GetData(String)

Zwraca dane w formacie określonym przez ciąg.

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

Ciąg określający format danych. Aby uzyskać zestaw wstępnie zdefiniowanych formatów danych, zobacz klasę DataFormats .

Zwraca

Object

Obiekt, który zawiera dane w określonym formacie lub null jeśli dane są niedostępne w określonym formacie.

Implementuje

Wyjątki

format to null.

Przykłady

W poniższym przykładzie użyto tej metody, aby najpierw sprawdzić, czy określony format danych jest dostępny (natywnie lub przez automatyczną konwersję); Jeśli określony format jest dostępny, przykład pobiera dane przy użyciu 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

Poniższy przykładowy kod używa GetDataPresent(String, Boolean) metody , aby najpierw sprawdzić, czy określony format danych jest dostępny natywnie (formaty danych automatycznie konwertowanych są filtrowane); jeśli określony format jest dostępny, przykład pobiera dane przy użyciu 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

Zobacz też

Dotyczy

GetData(Type)

Zwraca obiekt danych w formacie określonym przez Type obiekt.

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

Element Type określający format danych. Aby uzyskać zestaw wstępnie zdefiniowanych formatów danych, zobacz klasę DataFormats .

Zwraca

Object

Obiekt danych z danymi w określonym formacie lub null jeśli dane są niedostępne w określonym formacie.

Implementuje

Wyjątki

format to null.

Zobacz też

Dotyczy

GetData(String, Boolean)

Zwraca obiekt danych w określonym formacie, opcjonalnie konwertując dane na określony 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

Parametry

format
String

Ciąg określający format danych. Aby uzyskać zestaw wstępnie zdefiniowanych formatów danych, zobacz klasę DataFormats .

autoConvert
Boolean

true aby podjąć próbę automatycznej konwersji danych na określony format; false bez konwersji formatu danych.

Zwraca

Object

Obiekt danych z danymi w określonym formacie lub null jeśli dane są niedostępne w określonym formacie.

autoConvert Jeśli parametr to true i nie można przekonwertować danych na określony format lub jeśli automatyczna konwersja jest wyłączona (przez wywołanie SetData(String, Object, Boolean) z parametrem ustawionym autoConvert na false), ta metoda zwraca wartość null.

Implementuje

Wyjątki

format ma wartość null.

Zobacz też

Dotyczy