DataObject.GetDataPresent Metoda

Reference

Definice

Obor názvů:: System.Windows.Forms

Sestavení:: System.Windows.Forms.dll

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 formátu přidružena k zadanému formátu.

Přetížení

GetDataPresent(String)	Určuje, zda jsou data uložená v tomto DataObject souboru přidružena nebo zda mohou být převedena do zadaného formátu.
GetDataPresent(Type)	Určuje, zda jsou data uložená v tomto DataObject souboru přidružena nebo zda mohou být převedena do zadaného formátu.
GetDataPresent(String, Boolean)	Určuje, zda obsahuje DataObject data v zadaném formátu, nebo volitelně data, která lze převést do zadaného formátu.

GetDataPresent(String)

Určuje, zda jsou data uložená v tomto DataObject souboru přidružena nebo zda mohou být převedena do zadaného formátu.

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 informace o předdefinovaných formátech.

Návraty

Boolean

true pokud jsou data uložená v tomto DataObject souboru přidružená nebo mohou být převedena do zadaného formátu, jinak falsehodnota .

Implementuje

GetDataPresent(String)

Příklady

Následující příklad kódu určuje, zda data aktuálně uložená v tomto DataObject jsou přidruženy nebo mohou být převedeny do zadaného formátu. Nový DataObject se inicializuje s řetězcem a jeho přidruženým formátem zadaným jako text.

V příkladech se pak zobrazí, jestli v objektu existují textová DataObjectdata. Tento kód vyžaduje, aby textBox1 byl vytvořen.

Poznámky

Voláním této metody určíte, zda existuje formát před voláním GetData. Volejte GetFormats formáty, které jsou k dispozici v tomto DataObjectsouboru .

Poznámka

Data lze převést do jiného formátu, pokud byla uložena s určením, ž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 se dají převést na text.

Poznámka

Pokud nelze načíst žádná data, nevyvolá se žádná výjimka. false Místo toho se vrátí.

Viz také

Platí pro

GetDataPresent(Type)

Určuje, zda jsou data uložená v tomto DataObject souboru přidružena nebo zda mohou být převedena do zadaného formátu.

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

format: Type

Představuje Type formát, který chcete zkontrolovat.

Návraty

Boolean

true pokud jsou data uložená v tomto DataObject souboru přidružená nebo mohou být převedena do zadaného formátu, jinak falsehodnota .

Implementuje

GetDataPresent(Type)

Příklady

Následující příklad kódu určuje, zda data zadaného typu existují v objektu DataObjectnebo zda lze data převést na zadaný typ. Výsledek se zobrazí v textovém poli. Kód vyžaduje, aby textBox1 byl vytvořen.

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 formáty, které jsou k dispozici v tomto DataObjectsouboru .

Poznámka

Pokud nelze načíst žádná data, nevyvolá se žádná výjimka. false Místo toho se vrátí.

Viz také

Platí pro

GetDataPresent(String, Boolean)

Určuje, zda obsahuje DataObject data v zadaném formátu, nebo volitelně data, která lze převést do zadaného formátu.

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 informace o předdefinovaných formátech.

autoConvert: Boolean

true chcete-li zjistit, zda mohou být data uložená v tomto DataObject formátu převedena do zadaného formátu; false chcete-li zkontrolovat, zda jsou data v zadaném formátu.

Návraty

Boolean

truepokud jsou data v zadaném formátu nebo mohou být převedena do zadaného formátu; v opačném případě . false

Implementuje

GetDataPresent(String, Boolean)

Příklady

Následující příklad kódu určuje, zda jsou data aktuálně uložená DataObject v souboru přidružena k zadanému formátu. Nejprve se nový DataObject inicializuje pomocí řetězce, který určí jeho formát jako text.

DataObject Potom se dotazuje na data přidružená k textovému formátu a parametr zadá autoConvert jako false. Výsledek tohoto dotazu se vytiskne v textovém poli.

DataObject Potom se dotazuje na data přidružená k formátu řetězce a parametr zadá autoConvert jako true. Výsledky se vytisknou v textovém poli. Tento kód vyžaduje, aby textBox1 byl vytvořen.

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 formáty, které jsou k dispozici v tomto DataObjectsouboru .

Tato metoda vrátí, true když:

Parametr autoConvert je true a data jsou ve formátu, který lze převést do příslušného formátu.
Parametr autoConvert je false a data jsou v odpovídajícím formátu.

Tato metoda vrátí, false když:

Parametr autoConvert je true 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 data uložena s automatickým převodem nastaveným na false.
Parametr autoConvert je false a data v tomto DataObject formátu neexistují.

Poznámka

Data lze převést do jiného formátu, pokud byla uložena s určením, ž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 se dají převést na text.

Poznámka

Pokud nelze načíst žádná data, nevyvolá se žádná výjimka. false Místo toho se vrátí.

Viz také

Platí pro

Sdílet prostřednictvím

DataObject.GetDataPresent Metoda

Definice

Přetížení

GetDataPresent(String)

Parametry

Návraty

Implementuje

Příklady

Poznámky

Viz také

Platí pro

GetDataPresent(Type)

Parametry

Návraty

Implementuje

Příklady

Poznámky

Viz také

Platí pro

GetDataPresent(String, Boolean)

Parametry

Návraty

Implementuje

Příklady

Poznámky

Viz také

Platí pro

Další materiály