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 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

Boolean

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

GetDataPresent(String)

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

format: Type

Type představující formát, který chcete zkontrolovat.

Návraty

Boolean

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

GetDataPresent(Type)

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

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

Boolean

true, pokud jsou data v nebo lze převést na zadaný formát; jinak false.

Implementuje

GetDataPresent(String, Boolean)

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 falsezadá 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 truezadá 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 je true a data jsou ve formátu, který lze převést na příslušný formát.
Parametr autoConvert je false a data jsou v příslušném formátu.

Tato metoda vrátí false v těchto případech:

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 uložena s automatickým převodem nastaveným na false.
Parametr autoConvert je false 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.

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