DataObject.GetData Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
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.