IDataObject.GetData 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í.

Načte data přidružená k zadanému formátu dat.

Přetížení

GetData(String)	Načte data přidružená k zadanému formátu dat.
GetData(Type)	Načte data přidružená k zadanému formátu typu třídy.
GetData(String, Boolean)	Načte data přidružená k zadanému formátu dat pomocí logické hodnoty k určení, jestli se mají data převést do formátu.

GetData(String)

Načte data přidružená k zadanému formátu dat.

public:
 System::Object ^ GetData(System::String ^ format);

public object GetData (string format);

public object? GetData (string format);

abstract member GetData : string -> obj

Public Function GetData (format As String) As Object

Parametry

format: String

Formát dat, která se mají načíst. Viz DataFormats předdefinované formáty.

Návraty

Object

Data přidružená k zadanému formátu nebo null.

Příklady

Tento příklad používá DataObject třídu, která implementuje IDataObject, k předvedení použití GetData metody. Metoda se používá k načtení dat uložených v myDataObject, která jsou přidružena k Text formátu. V příkladu se předpokládá, že jste již vytvořili pojmenovaný Form Form1 a pojmenovaný TextBox textBox1.

private:
   void GetData1()
   {
      // Creates a new data object using a string and the text format.
      String^ myString = "My text string";
      DataObject^ myDataObject = gcnew DataObject( DataFormats::Text,myString );

      // Displays the string in a text box.
      textBox1->Text = myDataObject->GetData( DataFormats::Text )->ToString();
   }

private void GetData1() 
{
    // Creates a new data object using a string and the text format.
    string myString = "My text string";
    DataObject myDataObject = new DataObject(DataFormats.Text, myString);

    // Displays the string in a text box.
    textBox1.Text = myDataObject.GetData(DataFormats.Text).ToString();
}

Private Sub GetData1()
    ' Creates a new data object using a string and the text format.
    Dim myString As String = "My text string"
    Dim myDataObject As New DataObject(DataFormats.Text, myString)

    ' Displays the string in a text box.
    textBox1.Text = myDataObject.GetData(DataFormats.Text).ToString()
End Sub

Poznámky

Pokud tato metoda nemůže najít data v zadaném formátu, pokusí se převést data do formátu. Pokud data nelze převést na zadaný formát, tato metoda vrátí null.

Chcete-li zjistit, zda jsou data přidružena nebo lze převést na formát, volání GetDataPresent před voláním GetData. Volání GetFormats seznamu platných formátů pro data uložená v této instanci

Poznámka

Data se dají převést do jiného formátu, pokud byla uložena, a pokud je požadovaný formát kompatibilní s uloženým formátem. Data uložená jako Unicode lze například převést na text.

Implementace této metody naleznete v tématu DataObject.GetData.

Viz také

Platí pro

GetData(Type)

Načte data přidružená k zadanému formátu typu třídy.

public:
 System::Object ^ GetData(Type ^ format);

public object GetData (Type format);

public object? GetData (Type format);

abstract member GetData : Type -> obj

Public Function GetData (format As Type) As Object

Parametry

format: Type

A Type představující formát dat, který se má načíst. Viz DataFormats předdefinované formáty.

Návraty

Object

Data přidružená k zadanému formátu nebo null.

Příklady

Tento příklad používá DataObject třídu, která implementuje IDataObject, demonstruje použití GetData metody. Metoda se používá k načtení dat uložených v myObject, která jsou přidružena ke konkrétnímu typu, myType. Typ načtených dat se zobrazí v poli se zprávou. Příklad předpokládá, že jste již vytvořili pojmenovaný Form Form1.

private:
   void GetData2()
   {
      // Creates a component.
      Component^ myComponent = gcnew Component;

      // Creates a data object, and assigns it the component.
      DataObject^ myDataObject = gcnew DataObject( myComponent );

      // Creates a type, myType, to store the type of data.
      Type^ myType = myComponent->GetType();

      // Retrieves the data using myType to represent its type.
      Object^ myObject = myDataObject->GetData( myType );
      if ( myObject != nullptr )
            MessageBox::Show( "The data type stored in the data object is " +
                  myObject->GetType()->Name + "." );
      else
            MessageBox::Show( "Data of the specified type was not stored in the data object." );
   }

       private void GetData2() 
       {
           // Creates a component.
           Component myComponent = new Component();

           // Creates a data object, and assigns it the component.
           DataObject myDataObject = new DataObject(myComponent);

           // Creates a type, myType, to store the type of data.
           Type myType = myComponent.GetType();

           // Retrieves the data using myType to represent its type.
           Object myObject = myDataObject.GetData(myType);
           if(myObject != null)
               MessageBox.Show("The data type stored in the data object is " +
                   myObject.GetType().Name + ".");
           else
               MessageBox.Show("Data of the specified type was not stored " +
                   "in the data object.");
       }

Private Sub GetData2()
    ' Creates a component.
    Dim myComponent As New System.ComponentModel.Component()

    ' Creates a data object, and assigns it the component.
    Dim myDataObject As New DataObject(myComponent)

    ' Creates a type, myType, to store the type of data.
    Dim myType As Type = myComponent.GetType()

    ' Retrieves the data using myType to represent its type.
    Dim myObject As [Object] = myDataObject.GetData(myType)
    If (myObject IsNot Nothing) Then
        MessageBox.Show("The data type stored in the data object is " + myObject.GetType().Name + ".")
    Else
        MessageBox.Show("Data of the specified type was not stored " + "in the data object.")
    End If
End Sub

Poznámky

Pokud tato metoda nemůže najít data v zadaném formátu, pokusí se převést data do formátu. Pokud data nelze převést na zadaný formát, tato metoda vrátí null.

Poznámka

Data se dají převést do jiného formátu, pokud byla uložena, a pokud je požadovaný formát kompatibilní s uloženým formátem. Data uložená jako Unicode lze například převést na text.

Implementace této metody naleznete v tématu DataObject.GetData.

Viz také

Platí pro

GetData(String, Boolean)

Načte data přidružená k zadanému formátu dat pomocí logické hodnoty k určení, jestli se mají data převést do formátu.

public:
 System::Object ^ GetData(System::String ^ format, bool autoConvert);

public object GetData (string format, bool autoConvert);

public object? GetData (string format, bool autoConvert);

abstract member GetData : string * bool -> obj

Public Function GetData (format As String, autoConvert As Boolean) As Object

Parametry

format: String

Formát dat, která se mají načíst. Viz DataFormats předdefinované formáty.

autoConvert: Boolean

true převést data do zadaného formátu; falsev opačném případě .

Návraty

Object

Data přidružená k zadanému formátu nebo null.

Příklady

Tento příklad používá DataObject třídu, která implementuje IDataObject, demonstruje použití GetData metody. Příklad načte data uložená v parametru DataObjectpomocí parametru autoConvert k určení, zda se má formát dat převést nebo ne. myDataObject Nejprve se vytvoří textová data. Pak se příklad pokusí načíst data dvakrát. V první zkušební verzi určuje jeho formát jako řetězec a nastaví autoConvert parametr na false. Tato zkušební verze selže a výsledek se zobrazí v poli se zprávou s popiskem Zpráva #1. V druhé zkušební verzi příklad načte stejná data s parametrem autoConvert nastaveným na true. Tato zkušební verze bude úspěšná a výsledek se zobrazí v poli se zprávou s popiskem Zpráva #2. V příkladu se předpokládá, že jste vytvořili pojmenovanou Form Form1.

private:
   void GetData3()
   {
      // Creates a new data object using a text string.
      String^ myString = "Hello World!";
      DataObject^ myDataObject = gcnew DataObject( DataFormats::Text,myString );

      // Displays the string with autoConvert equal to false.
      if ( myDataObject->GetData( "System::String", false ) != nullptr )
      {
         // Displays the string in a message box.
         MessageBox::Show( myDataObject->GetData( "System::String", false ) + ".", "Message #1" );
      }
      else
            MessageBox::Show( "Could not find data of the specified format.", "Message #1" );

      // Displays a not found message in a message box.
      // Displays the string in a text box with autoConvert equal to true.
      String^ myData = "The data is " + myDataObject->GetData( "System::String", true ) + ".";
      MessageBox::Show( myData, "Message #2" );
   }

       private void GetData3() 
       {
           // Creates a new data object using a text string.
           string myString = "Hello World!";
           DataObject myDataObject = new DataObject(DataFormats.Text, myString);

           // Displays the string with autoConvert equal to false.
           if (myDataObject.GetData("System.String", false) != null) 
           {
               // Displays the string in a message box.
               MessageBox.Show(myDataObject.GetData("System.String", false).ToString() + ".", "Message #1");
           } 
           else
           {
               // Displays a not found message in a message box.
               MessageBox.Show("Could not find data of the specified format.", "Message #1");
           }

           // Displays the string in a text box with autoConvert equal to true.
           string myData = "The data is " + myDataObject.GetData("System.String", true).ToString() +".";
           MessageBox.Show(myData,"Message #2");
       }

Private Sub GetData3()
    ' Creates a new data object using a text string.
    Dim myString As String = "Hello World!"
    Dim myDataObject As New DataObject(DataFormats.Text, myString)

    ' Displays the string with autoConvert equal to false.
    If (myDataObject.GetData("System.String", False) IsNot Nothing) Then
        ' Displays the string in a message box.
        MessageBox.Show(myDataObject.GetData("System.String", False).ToString() + ".", "Message #1")
        ' Displays a not found message in a message box.
    Else
        MessageBox.Show("Could not find data of the specified format.", "Message #1")
    End If

    ' Displays the string in a text box with autoConvert equal to true.
    Dim myData As String = "The data is " + myDataObject.GetData("System.String", True).ToString()
    MessageBox.Show(myData, "Message #2")
End Sub

Poznámky

autoConvert Pokud parametr je true a tato metoda nemůže najít data v zadaném formátu, pokusí se převést data do formátu. Pokud data nelze převést do zadaného formátu nebo pokud byla data uložena s parametrem autoConvert nastaveným na false, tato metoda vrátí null.

autoConvert Pokud je falseparametr , tato metoda vrátí data v zadaném formátu, nebo null pokud žádná data v tomto formátu nelze najít.

Poznámka

Data se dají převést do jiného formátu, pokud byla uložena, a pokud je požadovaný formát kompatibilní s uloženým formátem. Data uložená jako Unicode lze například převést na text.

Implementace této metody naleznete v tématu DataObject.GetData.

Viz také

Platí pro

IDataObject.GetData Metoda

Definice

Přetížení

GetData(String)

Parametry

Návraty

Příklady

Poznámky

Viz také

Platí pro

GetData(Type)

Parametry

Návraty

Příklady

Poznámky

Viz také

Platí pro

GetData(String, Boolean)

Parametry

Návraty

Příklady

Poznámky

Viz také

Platí pro

Další materiály