DataObject.GetData Methode

Definitie

Retourneert gegevens in een opgegeven gegevensindeling.

Overloads

Name Description
GetData(String)

Retourneert gegevens in een indeling die is opgegeven door een tekenreeks.

GetData(Type)

Retourneert een gegevensobject in een indeling die is opgegeven door een Type object.

GetData(String, Boolean)

Retourneert een gegevensobject in een opgegeven indeling, optioneel het converteren van de gegevens naar de opgegeven indeling.

GetData(String)

Retourneert gegevens in een indeling die is opgegeven door een tekenreeks.

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

Parameters

format
String

Een tekenreeks die de indeling voor de gegevens aangeeft. Zie de DataFormats klasse voor een set vooraf gedefinieerde gegevensindelingen.

Retouren

Een object dat de gegevens in de opgegeven indeling bevat of null als de gegevens niet beschikbaar zijn in de opgegeven indeling.

Implementeringen

Uitzonderingen

format is null.

Voorbeelden

In het volgende voorbeeld wordt deze methode gebruikt om eerst te controleren of een opgegeven gegevensindeling beschikbaar is (systeemeigen of door automatisch converteren); als de opgegeven indeling beschikbaar is, haalt het voorbeeld de gegevens op met behulp van de GetData(String) methode.

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

In de volgende voorbeeldcode wordt de GetDataPresent(String, Boolean) methode gebruikt om eerst te controleren of een opgegeven gegevensindeling systeemeigen beschikbaar is (automatisch converteerbare gegevensindelingen worden gefilterd). Als de opgegeven indeling beschikbaar is, haalt het voorbeeld de gegevens op met behulp van de GetData(String) methode.

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

Zie ook

Van toepassing op

GetData(Type)

Retourneert een gegevensobject in een indeling die is opgegeven door een Type object.

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

Parameters

format
Type

Een Type die de indeling voor de gegevens aangeeft. Zie de DataFormats klasse voor een set vooraf gedefinieerde gegevensindelingen.

Retouren

Een gegevensobject met de gegevens in de opgegeven indeling of null als de gegevens niet beschikbaar zijn in de opgegeven indeling.

Implementeringen

Uitzonderingen

format is null.

Zie ook

Van toepassing op

GetData(String, Boolean)

Retourneert een gegevensobject in een opgegeven indeling, optioneel het converteren van de gegevens naar de opgegeven indeling.

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

Parameters

format
String

Een tekenreeks die de indeling voor de gegevens aangeeft. Zie de DataFormats klasse voor een set vooraf gedefinieerde gegevensindelingen.

autoConvert
Boolean

true om de gegevens automatisch te converteren naar de opgegeven indeling; false voor geen conversie van gegevensindeling.

Retouren

Een gegevensobject met de gegevens in de opgegeven indeling of null als de gegevens niet beschikbaar zijn in de opgegeven indeling.

Als de autoConvert parameter is true en de gegevens niet kunnen worden geconverteerd naar de opgegeven indeling, of als automatische conversie is uitgeschakeld (door aan te roepen SetData(String, Object, Boolean) met de autoConvert parameter ingesteld op false), retourneert nulldeze methode .

Implementeringen

Uitzonderingen

format is null.

Zie ook

Van toepassing op