DataObject.GetDataPresent Metódus
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
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 |
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.