DataObject.GetDataPresent Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Určuje, zda jsou data k dispozici v zadaném formátu nebo zda je lze převést na.
Přetížení
GetDataPresent(String) |
Určuje, zda jsou data k dispozici ve formátu určeném řetězcem nebo lze je převést na. |
GetDataPresent(Type) |
Určuje, zda jsou data k dispozici ve formátu určeném objektem Type nebo lze je převést na. |
GetDataPresent(String, Boolean) |
Určuje, zda jsou data k dispozici v zadaném formátu nebo zda je lze převést na. Příznak |
Poznámky
Voláním GetDataPresent určete, zda je v tomto datovém objektu k dispozici formát před voláním GetData. Voláním GetFormats získáte seznam všech formátů, které jsou k dispozici v tomto datovém objektu.
GetDataPresent(String)
Určuje, zda jsou data k dispozici ve formátu určeném řetězcem nebo lze je převést na.
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
Parametry
- format
- String
Řetězec, který určuje formát dat. Sadu předdefinovaných datových formátů najdete ve DataFormats třídě .
Návraty
true
pokud jsou data v zadaném formátu nebo mohou být převedena na; v opačném případě . false
Implementuje
Výjimky
format
je null
.
Příklady
Následující příklad používá tuto metodu k dotazování na přítomnost konkrétního datového formátu pomocí řetězce popisovače.
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
Poznámky
Voláním GetDataPresent určete, zda je v tomto datovém objektu k dispozici formát před voláním GetData. Voláním GetFormats získáte seznam všech formátů, které jsou k dispozici v tomto datovém objektu.
Viz také
Platí pro
GetDataPresent(Type)
Určuje, zda jsou data k dispozici ve formátu určeném objektem Type nebo lze je převést na.
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
Parametry
- format
- Type
A Type , který určuje formát dat, který chcete zkontrolovat. F nebo sadu předdefinovaných datových formátů, viz DataFormats třída.
Návraty
true
pokud jsou data v zadaném formátu nebo mohou být převedena na; v opačném případě . false
Implementuje
Výjimky
format
je null
.
Příklady
Následující příklad používá tuto metodu k dotazování na přítomnost konkrétního datového formátu podle typu.
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
Poznámky
Voláním GetDataPresent určete, zda je v tomto datovém objektu k dispozici formát před voláním GetData. Voláním GetFormats získáte seznam všech formátů, které jsou k dispozici v tomto datovém objektu.
Viz také
Platí pro
GetDataPresent(String, Boolean)
Určuje, zda jsou data k dispozici v zadaném formátu nebo zda je lze převést na. Příznak Boolean
označuje, jestli se má zkontrolovat, jestli je možné data převést do zadaného formátu, pokud nejsou v daném formátu k dispozici.
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
Parametry
- format
- String
Řetězec, který určuje formát dat, který chcete zkontrolovat. Sadu předdefinovaných datových formátů najdete ve DataFormats třídě .
- autoConvert
- Boolean
false
kontrolovat pouze zadaný formát; true
a zkontrolujte také, zda lze data uložená v tomto datovém objektu převést do zadaného formátu.
Návraty
true
pokud jsou data v zadaném formátu nebo mohou být převedena na; v opačném případě . false
Implementuje
Výjimky
format
je null
.
Příklady
Následující příklad používá tuto metodu k dotazování na data pomocí řetězce popisovače a určuje, jak zacházet s automaticky konvertibilními datovými formáty.
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
Poznámky
Voláním GetDataPresent určete, zda je v tomto datovém objektu k dispozici formát před voláním GetData. Voláním GetFormats získáte seznam všech formátů, které jsou k dispozici v tomto datovém objektu.