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 uložená v tomto DataObject přidružena k zadanému formátu.
Přetížení
GetDataPresent(String) |
Určuje, zda jsou data uložená v tomto DataObject přidružena nebo lze převést na zadaný formát. |
GetDataPresent(Type) |
Určuje, zda jsou data uložená v tomto DataObject přidružena nebo lze převést na zadaný formát. |
GetDataPresent(String, Boolean) |
Určuje, zda tato DataObject obsahuje data v zadaném formátu, nebo volitelně obsahuje data, která lze převést na zadaný formát. |
GetDataPresent(String)
Určuje, zda jsou data uložená v tomto DataObject přidružena nebo lze převést na zadaný formát.
public:
virtual bool GetDataPresent(System::String ^ format);
public virtual bool GetDataPresent (string format);
abstract member GetDataPresent : string -> bool
override this.GetDataPresent : string -> bool
Public Overridable Function GetDataPresent (format As String) As Boolean
Parametry
- format
- String
Formát, který chcete zkontrolovat. Viz DataFormats pro předdefinované formáty.
Návraty
true
, pokud jsou data uložená v této DataObject přidružena nebo lze převést na zadaný formát; jinak false
.
Implementuje
Příklady
Následující příklad kódu určuje, zda jsou data aktuálně uložená v tomto DataObject přidružena nebo lze převést na zadaný formát. Nový DataObject se inicializuje s řetězcem a přidruženým formátem zadaným jako text.
Potom příklady vytisknou, zda textová data existují v DataObject. Tento kód vyžaduje vytvoření textBox1
.
Poznámky
Voláním této metody určíte, zda existuje formát před voláním GetData. Volejte GetFormats pro formáty, které jsou k dispozici v tomto DataObject.
Poznámka
Data se dají převést do jiného formátu, pokud byla uložena a určuje, že převod je povolený, a pokud je požadovaný formát kompatibilní s uloženým formátem. Například data uložená jako Unicode lze převést na text.
Poznámka
Pokud nelze načíst žádná data, nevyvolá se žádná výjimka. Místo toho se vrátí false
.
Viz také
Platí pro
GetDataPresent(Type)
Určuje, zda jsou data uložená v tomto DataObject přidružena nebo lze převést na zadaný formát.
public:
virtual bool GetDataPresent(Type ^ format);
public virtual bool GetDataPresent (Type format);
abstract member GetDataPresent : Type -> bool
override this.GetDataPresent : Type -> bool
Public Overridable Function GetDataPresent (format As Type) As Boolean
Parametry
Návraty
true
, pokud jsou data uložená v této DataObject přidružena nebo lze převést na zadaný formát; jinak false
.
Implementuje
Příklady
Následující příklad kódu určuje, zda data zadaného typu existují v DataObject, nebo zda lze data převést na zadaný typ. Výsledek se zobrazí v textovém poli. Kód vyžaduje vytvoření textBox1
.
private:
void GetIfPresent2()
{
// Creates a component to store in the data object.
Component^ myComponent = gcnew Component;
// Creates a new data object and assigns it the component.
DataObject^ myDataObject = gcnew DataObject( myComponent );
// Creates a type to store the type of data.
Type^ myType = myComponent->GetType();
// Determines if the DataObject has data of the Type format.
textBox1->Text = String::Concat( "Is the specified data type available ",
"in the DataObject? ", myDataObject->GetDataPresent( myType ), "\n" );
// Retrieves the data using its type format, and displays the type.
Object^ myObject = myDataObject->GetData( myType );
textBox1->Text = String::Concat( textBox1->Text, "The data type stored ",
"in the DataObject is: ", myObject->GetType()->Name );
}
private void GetIfPresent2() {
// Creates a component to store in the data object.
Component myComponent = new Component();
// Creates a new data object and assigns it the component.
DataObject myDataObject = new DataObject(myComponent);
// Creates a type to store the type of data.
Type myType = myComponent.GetType();
// Determines if the DataObject has data of the Type format.
textBox1.Text = "Is the specified data type available in the " +
"DataObject? " + myDataObject.GetDataPresent(myType).ToString() + '\n';
// Retrieves the data using its type format, and displays the type.
Object myObject = myDataObject.GetData(myType);
textBox1.Text += "The data type stored in the DataObject is: " +
myObject.GetType().Name;
}
Private Sub GetIfPresent2()
' Creates a component to store in the data object.
Dim myComponent As New Component()
' Creates a new data object and assigns it the component.
Dim myDataObject As New DataObject(myComponent)
' Creates a type to store the type of data.
Dim myType As Type = myComponent.GetType()
' Determines if the DataObject has data of the Type format.
textBox1.Text = "Is the specified data type available in the " & "DataObject? " & _
myDataObject.GetDataPresent(myType).ToString() & ControlChars.Cr
' Retrieves the data using its type format, and displays the type.
Dim myObject As Object = myDataObject.GetData(myType)
textBox1.Text += "The data type stored in the DataObject is: " + myObject.GetType().Name
End Sub
Poznámky
Voláním této metody určíte, zda existuje formát před voláním GetData. Volejte GetFormats pro formáty, které jsou k dispozici v tomto DataObject.
Poznámka
Data se dají převést do jiného formátu, pokud byla uložena a určuje, že převod je povolený, a pokud je požadovaný formát kompatibilní s uloženým formátem. Například data uložená jako Unicode lze převést na text.
Poznámka
Pokud nelze načíst žádná data, nevyvolá se žádná výjimka. Místo toho se vrátí false
.
Viz také
Platí pro
GetDataPresent(String, Boolean)
Určuje, zda tato DataObject obsahuje data v zadaném formátu, nebo volitelně obsahuje data, která lze převést na zadaný formát.
public:
virtual bool GetDataPresent(System::String ^ format, bool autoConvert);
public virtual bool GetDataPresent (string format, bool autoConvert);
abstract member GetDataPresent : string * bool -> bool
override this.GetDataPresent : string * bool -> bool
Public Overridable Function GetDataPresent (format As String, autoConvert As Boolean) As Boolean
Parametry
- format
- String
Formát, který chcete zkontrolovat. Viz DataFormats pro předdefinované formáty.
- autoConvert
- Boolean
true
určit, zda lze data uložená v této DataObject převést do zadaného formátu; false
zkontrolujte, jestli jsou data v zadaném formátu.
Návraty
true
, pokud jsou data v nebo lze převést na zadaný formát; jinak false
.
Implementuje
Příklady
Následující příklad kódu určuje, zda data aktuálně uložená v DataObject jsou přidružena k zadanému formátu. Nejprve se inicializuje nový DataObject řetězcem, který určuje jeho formát jako text.
Potom se DataObject dotazuje na data přidružená k textovému formátu a jako false
zadá parametr autoConvert
. Výsledek tohoto dotazu se vytiskne do textového pole.
Potom se DataObject dotazuje na data přidružená k řetězcovém formátu a jako true
zadá parametr autoConvert
. Výsledky se vytisknou v textovém poli. Tento kód vyžaduje vytvoření textBox1
.
private:
void GetIfPresent3()
{
// Creates a new data object using a string and the text format.
DataObject^ myDataObject = gcnew DataObject( DataFormats::Text, "Another string" );
// Prints the string in a text box with autoconvert = false.
if ( myDataObject->GetDataPresent( "System.String", false ) )
{
// Prints the string in a text box.
textBox1->Text = String::Concat(
myDataObject->GetData( "System.String", false )->ToString(), "\n" );
}
else
{
textBox1->Text = "Could not convert data to specified format\n";
}
// Prints the string in a text box with autoconvert = true.
textBox1->Text = String::Concat( textBox1->Text,
"With autoconvert = true, you can convert text to string format. String is: ",
myDataObject->GetData( "System.String", true )->ToString() );
}
private void GetIfPresent3() {
// Creates a new data object using a string and the text format.
DataObject myDataObject = new DataObject(DataFormats.Text, "Another string");
// Prints the string in a text box with autoconvert = false.
if(myDataObject.GetDataPresent("System.String", false)) {
// Prints the string in a text box.
textBox1.Text = myDataObject.GetData("System.String", false).ToString() + '\n';
} else
{
textBox1.Text = "Could not convert data to specified format" + '\n';
}
// Prints the string in a text box with autoconvert = true.
textBox1.Text += "With autoconvert = true, you can convert text to string format. " +
"String is: " + myDataObject.GetData("System.String", true).ToString();
}
Private Sub GetIfPresent3()
' Creates a new data object using a string and the text format.
Dim myDataObject As New DataObject(DataFormats.Text, "Another string")
' Prints the string in a text box with autoconvert = false.
If myDataObject.GetDataPresent("System.String", False) Then
' Prints the string in a text box.
textBox1.Text = myDataObject.GetData("System.String", False).ToString() & ControlChars.Cr
Else
textBox1.Text = "Could not convert data to specified format" & ControlChars.Cr
End If
' Prints the string in a text box with autoconvert = true.
textBox1.Text &= "With autoconvert = true, you can convert text to string format. " & _
"String is: " & myDataObject.GetData("System.String", True).ToString()
End Sub
Poznámky
Voláním této metody určíte, zda existuje formát před voláním GetData. Volejte GetFormats pro formáty, které jsou k dispozici v tomto DataObject.
Tato metoda vrátí true
v těchto případech:
Parametr
autoConvert
jetrue
a data jsou ve formátu, který lze převést na příslušný formát.Parametr
autoConvert
jefalse
a data jsou v příslušném formátu.
Tato metoda vrátí false
v těchto případech:
Parametr
autoConvert
jetrue
a tato metoda nemůže najít data v zadaném formátu a nemůže převést data do zadaného formátu nebo byla uložena s automatickým převodem nastaveným nafalse
.Parametr
autoConvert
jefalse
a data v tomto DataObject v zadaném formátu neexistují.
Poznámka
Data se dají převést do jiného formátu, pokud byla uložena a určuje, že převod je povolený a jestli je požadovaný formát kompatibilní s uloženým formátem. Například data uložená jako Unicode lze převést na text.
Poznámka
Pokud nelze načíst žádná data, nevyvolá se žádná výjimka. Místo toho se vrátí false
.