IDataObject.GetData Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Windows.Forms

Zestaw:: System.Windows.Forms.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Pobiera dane skojarzone z określonym formatem danych.

Przeciążenia

GetData(String)	Pobiera dane skojarzone z określonym formatem danych.
GetData(Type)	Pobiera dane skojarzone z określonym formatem typu klasy.
GetData(String, Boolean)	Pobiera dane skojarzone z określonym formatem danych przy użyciu wartości logicznej w celu określenia, czy dane mają być konwertowane na format.

GetData(String)

Pobiera dane skojarzone z określonym formatem danych.

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

Format danych do pobrania. Zobacz, aby zapoznać się DataFormats ze wstępnie zdefiniowanymi formatami.

Zwraca

Object

Dane skojarzone z określonym formatem lub null.

Przykłady

W tym przykładzie DataObject użyto klasy , która implementuje IDataObject, , aby zademonstrować użycie GetData metody. Metoda służy do pobierania danych przechowywanych w myDataObjectpliku , który jest skojarzony z formatem Text . W przykładzie założono, że utworzono już Form nazwę Form1 i TextBox nazwę 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

Uwagi

Jeśli ta metoda nie może odnaleźć danych w określonym formacie, próbuje przekonwertować dane na format. Jeśli nie można przekonwertować danych na określony format, ta metoda zwraca wartość null.

Aby określić, czy dane są skojarzone z, czy można je przekonwertować, należy wywołać metodę przed wywołaniem metody GetDataPresent GetData. Wywołaj GetFormats listę prawidłowych formatów danych przechowywanych w tym wystąpieniu.

Uwaga

Dane można przekonwertować na inny format, jeśli były przechowywane, określając, że konwersja jest dozwolona, a żądany format jest zgodny z zapisanym formatem. Na przykład dane przechowywane jako Unicode można przekonwertować na tekst.

Aby zapoznać się z implementacją tej metody, zobacz DataObject.GetData.

Zobacz też

Dotyczy

GetData(Type)

Pobiera dane skojarzone z określonym formatem typu klasy.

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

Reprezentująca Type format danych do pobrania. Zobacz, aby zapoznać się DataFormats ze wstępnie zdefiniowanymi formatami.

Zwraca

Object

Dane skojarzone z określonym formatem lub null.

Przykłady

W tym przykładzie DataObject użyto klasy , która implementuje IDataObjectmetodę GetData , aby zademonstrować użycie metody . Metoda służy do pobierania danych przechowywanych w myObjectobiekcie , który jest skojarzony z określonym typem . myType Typ pobranych danych jest wyświetlany w polu komunikatu. W przykładzie założono, że utworzono już Form nazwę 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

Uwagi

Uwaga

Aby zapoznać się z implementacją tej metody, zobacz DataObject.GetData.

Zobacz też

Dotyczy

GetData(String, Boolean)

Pobiera dane skojarzone z określonym formatem danych przy użyciu wartości logicznej w celu określenia, czy dane mają być konwertowane na format.

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

Format danych do pobrania. Zobacz, aby zapoznać się DataFormats ze wstępnie zdefiniowanymi formatami.

autoConvert: Boolean

true w celu przekonwertowania danych na określony format; w przeciwnym razie , false.

Zwraca

Object

Dane skojarzone z określonym formatem lub null.

Przykłady

W tym przykładzie DataObject użyto klasy , która implementuje IDataObjectmetodę GetData , aby zademonstrować użycie metody . Przykład pobiera dane przechowywane w obiekcie DataObjectprzy użyciu parametru autoConvert , aby określić, czy format danych ma być konwertowany. myDataObject Najpierw jest tworzony przy użyciu danych tekstowych. Następnie przykład próbuje dwa razy pobrać dane. W pierwszej wersji próbnej określa format jako ciąg i ustawia autoConvert parametr na false. Ta wersja próbna kończy się niepowodzeniem, a wynik jest wyświetlany w polu komunikatu z etykietą "Message #1". W drugiej wersji próbnej przykład pobiera te same dane z parametrem ustawionym autoConvert na truewartość . Ta wersja próbna zakończy się pomyślnie, a wynik zostanie wyświetlony w polu komunikatu z etykietą "Message #2". W przykładzie założono, że utworzono Form nazwę 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

Uwagi

autoConvert Jeśli parametr jest true i ta metoda nie może odnaleźć danych w określonym formacie, próbuje przekonwertować dane na format. Jeśli nie można przekonwertować danych na określony format lub jeśli dane były przechowywane z parametrem ustawionym na autoConvertfalsewartość , ta metoda zwraca wartość null.

autoConvert Jeśli parametr to false, ta metoda zwraca dane w określonym formacie lub null jeśli nie można odnaleźć żadnych danych w tym formacie.

Uwaga

Aby zapoznać się z implementacją tej metody, zobacz DataObject.GetData.

Zobacz też

Dotyczy

IDataObject.GetData Metoda

Definicja

Przeciążenia

GetData(String)

Parametry

Zwraca

Przykłady

Uwagi

Zobacz też

Dotyczy

GetData(Type)

Parametry

Zwraca

Przykłady

Uwagi

Zobacz też

Dotyczy

GetData(String, Boolean)

Parametry

Zwraca

Przykłady

Uwagi

Zobacz też

Dotyczy

Opinia

Dodatkowe zasoby