DataObject.GetData Metodo

Definizione

Spazio dei nomi:

System.Windows

Assembly:

PresentationCore.dll

Restituisce dati in un formato dati specificato.

Overload

GetData(String)	Restituisce dati in un formato specificato da una stringa.
GetData(Type)	Restituisce un oggetto dati in un formato specificato dall'oggetto Type.
GetData(String, Boolean)	Restituisce un oggetto dati in un formato specificato, con conversione opzionale dei dati nel formato specificato.

GetData(String)

Restituisce dati in un formato specificato da una stringa.

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

Parametri

format

String

Stringa che specifica il formato dei dati. Per un set di formati dati predefiniti, vedere la classe DataFormats.

Restituisce

Object

Un oggetto che contiene i dati nel formato specificato, oppure null se i dati non sono disponibili nel formato specificato.

Implementazioni

GetData(String)

Eccezioni

ArgumentNullException

format è null.

Esempio

Nell'esempio seguente viene usato questo metodo per verificare innanzitutto se è disponibile un formato di dati specificato (in modo nativo o tramite conversione automatica); se il formato specificato è disponibile, l'esempio recupera i dati usando il GetData(String) metodo .

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

Nell'esempio di codice seguente viene utilizzato il GetDataPresent(String, Boolean) metodo per verificare innanzitutto se è disponibile un formato di dati specificato in modo nativo (i formati di dati convertibili automaticamente vengono filtrati). Se il formato specificato è disponibile, l'esempio recupera i dati usando il GetData(String) metodo .

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

Vedi anche

• Caricare un esempio di file eliminato

GetData(Type)

Restituisce un oggetto dati in un formato specificato dall'oggetto 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

Parametri

format

Type

Una Type che specifica il formato per i dati. Per un set di formati dati predefiniti, vedere la classe DataFormats.

Restituisce

Object

Un oggetto dati con i dati nel formato specificato, oppure null se i dati non sono disponibili nel formato specificato.

Implementazioni

GetData(Type)

Eccezioni

ArgumentNullException

format è null.

Vedi anche

• Caricare un esempio di file eliminato

GetData(String, Boolean)

Restituisce un oggetto dati in un formato specificato, con conversione opzionale dei dati nel formato specificato.

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

Parametri

format

String

Stringa che specifica il formato dei dati. Per un set di formati dati predefiniti, vedere la classe DataFormats.

autoConvert

Boolean

true per tentare di convertire automaticamente i dati nel formato specificato; false per non eseguire alcuna conversione del formato dati.

Restituisce

Object

Un oggetto dati con i dati nel formato specificato, oppure null se i dati non sono disponibili nel formato specificato.

Se il parametro autoConvert è true ed i dati non possono essere convertiti nel formato specificato, o se la conversione automatica è disabilitata (mediante la chiamata a SetData(String, Object, Boolean) con il parametro autoConvert impostato su false), questo metodo restituisce null.

Implementazioni

GetData(String, Boolean)

Eccezioni

ArgumentNullException

format è null.

Vedi anche

• Caricare un esempio di file eliminato