DataObject.GetDataPresent Metódus

Definíció

Meghatározza, hogy az adatok elérhetőek-e, vagy konvertálhatók-e egy megadott formátumban.

Túlterhelések

Name Description
GetDataPresent(String)

Meghatározza, hogy az adatok elérhetők-e egy sztring által megadott formátumban, vagy átalakíthatók-e.

GetDataPresent(Type)

Meghatározza, hogy az adatok elérhetők-e vagy átalakíthatók-e egy Type objektum által megadott formátumban.

GetDataPresent(String, Boolean)

Meghatározza, hogy az adatok elérhetőek-e, vagy konvertálhatók-e egy megadott formátumban. A Boolean jelölő jelzi, hogy az adatok konvertálhatók-e a megadott formátumra, ha nem érhetők el ebben a formátumban.

Megjegyzések

Hívás GetDataPresent annak megállapításához, hogy az adatobjektumban elérhető-e formátum a hívás GetDataelőtt. Hívás GetFormats az adatobjektumban elérhető összes formátum listájának lekéréséhez.

GetDataPresent(String)

Meghatározza, hogy az adatok elérhetők-e egy sztring által megadott formátumban, vagy átalakíthatók-e.

public:
 virtual bool GetDataPresent(System::String ^ format);
public bool GetDataPresent(string format);
abstract member GetDataPresent : string -> bool
override this.GetDataPresent : string -> bool
Public Function GetDataPresent (format As String) As Boolean

Paraméterek

format
String

Az adatok formátumát meghatározó sztring. Előre definiált adatformátumokat az DataFormats osztályban talál.

Válaszok

trueha az adatok a megadott formátumban találhatóak vagy konvertálhatók; egyéb esetben. false

Megvalósítás

Kivételek

format az null.

Példák

Az alábbi példa ezzel a módszerrel kérdezi le egy adott adatformátum jelenlétét leíró sztring alapján.

DataObject dataObject = new DataObject("Some string data to store...");

// Query for the presence of Text data in the data object, by a data format descriptor string.
// In this overload of GetDataPresent, the method will return true both for native data formats
// and when the data can automatically be converted to the specifed format.

// In this case, string data is present natively, so GetDataPresent returns "true".
string textData = null;
if (dataObject.GetDataPresent(DataFormats.StringFormat))
{
    textData = dataObject.GetData(DataFormats.StringFormat) as string;
}

// In this case, the Text data in the data object can be autoconverted to 
// Unicode text, so GetDataPresent returns "true".
byte[] unicodeData = null;
if (dataObject.GetDataPresent(DataFormats.UnicodeText))
{
    unicodeData = dataObject.GetData(DataFormats.UnicodeText) as byte[];
}
Dim dataObject As New DataObject("Some string data to store...")

' Query for the presence of Text data in the data object, by a data format descriptor string.
' In this overload of GetDataPresent, the method will return true both for native data formats
' and when the data can automatically be converted to the specifed format.

' In this case, string data is present natively, so GetDataPresent returns "true".
Dim textData As String = Nothing
If dataObject.GetDataPresent(DataFormats.StringFormat) Then
    textData = TryCast(dataObject.GetData(DataFormats.StringFormat), String)
End If

' In this case, the Text data in the data object can be autoconverted to 
' Unicode text, so GetDataPresent returns "true".
Dim unicodeData() As Byte = Nothing
If dataObject.GetDataPresent(DataFormats.UnicodeText) Then
    unicodeData = TryCast(dataObject.GetData(DataFormats.UnicodeText), Byte())
End If

Megjegyzések

Hívás GetDataPresent annak megállapításához, hogy az adatobjektumban elérhető-e formátum a hívás GetDataelőtt. Hívás GetFormats az adatobjektumban elérhető összes formátum listájának lekéréséhez.

Lásd még

A következőre érvényes:

GetDataPresent(Type)

Meghatározza, hogy az adatok elérhetők-e vagy átalakíthatók-e egy Type objektum által megadott formátumban.

public:
 virtual bool GetDataPresent(Type ^ format);
public bool GetDataPresent(Type format);
abstract member GetDataPresent : Type -> bool
override this.GetDataPresent : Type -> bool
Public Function GetDataPresent (format As Type) As Boolean

Paraméterek

format
Type

Az Type ellenőrizni kívánt adatformátumot meghatározó adatformátum. F vagy előre definiált adatformátumok halmaza, lásd az osztályt DataFormats .

Válaszok

trueha az adatok a megadott formátumban találhatóak vagy konvertálhatók; egyéb esetben. false

Megvalósítás

Kivételek

format az null.

Példák

Az alábbi példa ezt a módszert használja egy adott adatformátum típus szerinti jelenlétének lekérdezésére.

DataObject dataObject = new DataObject("Some string data to store...");

// Query for the presence of String data in the data object, by type.  In this overload 
// of GetDataPresent, the method will return true both for native data formats
// and when the data can automatically be converted to the specifed format.

// In this case, the Text data present in the data object can be autoconverted
// to type string (also represented by DataFormats.String), so GetDataPresent returns "true".
string stringData = null;
if (dataObject.GetDataPresent(typeof(string)))
{
    stringData = dataObject.GetData(DataFormats.Text) as string;
}
Dim dataObject As New DataObject("Some string data to store...")

' Query for the presence of String data in the data object, by type.  In this overload 
' of GetDataPresent, the method will return true both for native data formats
' and when the data can automatically be converted to the specifed format.

' In this case, the Text data present in the data object can be autoconverted
' to type string (also represented by DataFormats.String), so GetDataPresent returns "true".
Dim stringData As String = Nothing
If dataObject.GetDataPresent(GetType(String)) Then
    stringData = TryCast(dataObject.GetData(DataFormats.Text), String)
End If

Megjegyzések

Hívás GetDataPresent annak megállapításához, hogy az adatobjektumban elérhető-e formátum a hívás GetDataelőtt. Hívás GetFormats az adatobjektumban elérhető összes formátum listájának lekéréséhez.

Lásd még

A következőre érvényes:

GetDataPresent(String, Boolean)

Meghatározza, hogy az adatok elérhetőek-e, vagy konvertálhatók-e egy megadott formátumban. A Boolean jelölő jelzi, hogy az adatok konvertálhatók-e a megadott formátumra, ha nem érhetők el ebben a formátumban.

public:
 virtual bool GetDataPresent(System::String ^ format, bool autoConvert);
public bool GetDataPresent(string format, bool autoConvert);
abstract member GetDataPresent : string * bool -> bool
override this.GetDataPresent : string * bool -> bool
Public Function GetDataPresent (format As String, autoConvert As Boolean) As Boolean

Paraméterek

format
String

Egy sztring, amely megadja az ellenőrizni kívánt adatformátumot. Előre definiált adatformátumokat az DataFormats osztályban talál.

autoConvert
Boolean

false csak a megadott formátum ellenőrzése; true annak ellenőrzéséhez, hogy az ebben az adatobjektumban tárolt adatok konvertálhatók-e a megadott formátumra.

Válaszok

trueha az adatok a megadott formátumban találhatóak vagy konvertálhatók; egyéb esetben. false

Megvalósítás

Kivételek

format az null.

Példák

Az alábbi példa ezt a módszert használja az adatok leíró sztring szerinti lekérdezésére, és meghatározza az automatikusan konvertálható adatformátumok kezelését.

DataObject dataObject = new DataObject("Some string data to store...");

// Query for the presence of Text data in the data object, by data format descriptor string,
// and specifying whether auto-convertible data formats are acceptable.  

// In this case, Text data is present natively, so GetDataPresent returns "true".
string textData = null;
if (dataObject.GetDataPresent(DataFormats.Text, false /* Auto-convert? */))
{
    textData = dataObject.GetData(DataFormats.Text) as string;
}

// In this case, the Text data in the data object can be autoconverted to 
// Unicode text, but it is not available natively, so GetDataPresent returns "false".
byte[] unicodeData = null;
if (dataObject.GetDataPresent(DataFormats.UnicodeText, false /* Auto-convert? */))
{
    unicodeData = dataObject.GetData(DataFormats.UnicodeText) as byte[];
}

// In this case, the Text data in the data object can be autoconverted to 
// Unicode text, so GetDataPresent returns "true".
if (dataObject.GetDataPresent(DataFormats.UnicodeText, true /* Auto-convert? */))
{
    unicodeData = dataObject.GetData(DataFormats.UnicodeText) as byte[];
}
Dim dataObject As New DataObject("Some string data to store...")

' Query for the presence of Text data in the data object, by data format descriptor string,
' and specifying whether auto-convertible data formats are acceptable.  

' In this case, Text data is present natively, so GetDataPresent returns "true".
Dim textData As String = Nothing
If dataObject.GetDataPresent(DataFormats.Text, False) Then ' Auto-convert? 
    textData = TryCast(dataObject.GetData(DataFormats.Text), String)
End If

' In this case, the Text data in the data object can be autoconverted to 
' Unicode text, but it is not available natively, so GetDataPresent returns "false".
Dim unicodeData() As Byte = Nothing
If dataObject.GetDataPresent(DataFormats.UnicodeText, False) Then ' Auto-convert? 
    unicodeData = TryCast(dataObject.GetData(DataFormats.UnicodeText), Byte())
End If

' In this case, the Text data in the data object can be autoconverted to 
' Unicode text, so GetDataPresent returns "true".
If dataObject.GetDataPresent(DataFormats.UnicodeText, True) Then ' Auto-convert? 
    unicodeData = TryCast(dataObject.GetData(DataFormats.UnicodeText), Byte())
End If

Megjegyzések

Hívás GetDataPresent annak megállapításához, hogy az adatobjektumban elérhető-e formátum a hívás GetDataelőtt. Hívás GetFormats az adatobjektumban elérhető összes formátum listájának lekéréséhez.

Lásd még

A következőre érvényes: