IDataObject.GetData Methode

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft die Daten ab, die dem angegebenen Datenformat zugeordnet sind.

Überlädt

GetData(String)	Ruft die Daten ab, die dem angegebenen Datenformat zugeordnet sind.
GetData(Type)	Ruft die Daten ab, die dem angegebenen Format für den Klassentyp zugeordnet sind.
GetData(String, Boolean)	Ruft die dem angegebenen Format zugeordneten Daten ab. Mit einem booleschen Wert wird dabei festgelegt, ob die Daten in das Format konvertiert werden sollen.

GetData(String)

Ruft die Daten ab, die dem angegebenen Datenformat zugeordnet sind.

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

Parameter

format: String

Das Format der abzurufenden Daten. Vordefinierte Formate finden Sie unter DataFormats.

Gibt zurück

Object

Die dem angegebenen Format zugeordneten Daten oder null.

Beispiele

In diesem Beispiel wird die DataObject -Klasse verwendet, die implementiert wird, um die Verwendung der GetData -Methode zu veranschaulichenIDataObject,. Die -Methode wird verwendet, um die in gespeicherten Daten abzurufen, die dem myDataObjectText Format zugeordnet sind. Im Beispiel wird davon ausgegangen, dass Sie bereits einen Form benannten Form1 und einen TextBox mit dem Namen textBox1erstellt haben.

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

Hinweise

Wenn diese Methode keine Daten im angegebenen Format finden kann, versucht sie, die Daten in das Format zu konvertieren. Wenn die Daten nicht in das angegebene Format konvertiert werden können, gibt diese Methode zurück null.

Um zu bestimmen, ob Daten einem Format zugeordnet sind oder in ein Format konvertiert werden können, rufen Sie GetDataPresent auf, bevor Sie aufrufen GetData. Rufen Sie GetFormats eine Liste mit gültigen Formaten für die in dieser Instanz gespeicherten Daten auf.

Hinweis

Daten können in ein anderes Format konvertiert werden, wenn sie gespeichert wurden, um anzugeben, dass die Konvertierung zulässig ist, und wenn das angeforderte Format mit dem gespeicherten Format kompatibel ist. Beispielsweise können als Unicode gespeicherte Daten in Text konvertiert werden.

Eine Implementierung dieser Methode finden Sie unter DataObject.GetData.

Weitere Informationen

Gilt für:

GetData(Type)

Ruft die Daten ab, die dem angegebenen Format für den Klassentyp zugeordnet sind.

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

Parameter

format: Type

Ein Type, das das Format der abzurufenden Daten darstellt. Vordefinierte Formate finden Sie unter DataFormats.

Gibt zurück

Object

Die dem angegebenen Format zugeordneten Daten oder null.

Beispiele

In diesem Beispiel wird die DataObject -Klasse verwendet, die implementiert IDataObject, um die Verwendung der GetData -Methode zu veranschaulichen. Die -Methode wird verwendet, um die in myObjectgespeicherten Daten abzurufen, die einem bestimmten Typ zugeordnet sind, myType. Der Typ der abgerufenen Daten wird in einem Meldungsfeld angezeigt. Im Beispiel wird davon ausgegangen, dass Sie bereits einen Form namens Form1erstellt haben.

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

Hinweise

Hinweis

Eine Implementierung dieser Methode finden Sie unter DataObject.GetData.

Weitere Informationen

Gilt für:

GetData(String, Boolean)

Ruft die dem angegebenen Format zugeordneten Daten ab. Mit einem booleschen Wert wird dabei festgelegt, ob die Daten in das Format konvertiert werden sollen.

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

Parameter

format: String

Das Format der abzurufenden Daten. Vordefinierte Formate finden Sie unter DataFormats.

autoConvert: Boolean

true, wenn die Daten in das angegebene Format konvertiert werden sollen, andernfalls false.

Gibt zurück

Object

Die dem angegebenen Format zugeordneten Daten oder null.

Beispiele

In diesem Beispiel wird die DataObject -Klasse verwendet, die implementiert IDataObject, um die Verwendung der GetData -Methode zu veranschaulichen. Im Beispiel werden die in einem DataObjectgespeicherten Daten mithilfe des autoConvert Parameters abgerufen, um anzugeben, ob das Datenformat konvertiert werden soll. myDataObject Zunächst wird mit Textdaten erstellt. Anschließend versucht das Beispiel zweimal, die Daten abzurufen. In der ersten Testversion gibt es sein Format als Zeichenfolge an und legt den autoConvert Parameter auf fest false. Diese Testversion schlägt fehl, und das Ergebnis wird in einem Meldungsfeld mit der Bezeichnung "Nachricht #1" angezeigt. In der zweiten Testversion werden im Beispiel dieselben Daten abgerufen, wobei der autoConvert Parameter auf truefestgelegt ist. Diese Testversion ist erfolgreich, und das Ergebnis wird in einem Meldungsfeld mit der Bezeichnung "Nachricht #2" angezeigt. Im Beispiel wird davon ausgegangen, dass Sie einen Form mit dem Namen Form1erstellt haben.

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

Hinweise

Wenn der autoConvert Parameter ist true und diese Methode keine Daten im angegebenen Format finden kann, versucht sie, die Daten in das Format zu konvertieren. Wenn die Daten nicht in das angegebene Format konvertiert werden können oder wenn die Daten mit dem autoConvert Parameter auf gespeichert falsewurden, gibt diese Methode zurück null.

Wenn der autoConvert Parameter ist false, gibt diese Methode Daten im angegebenen Format zurück, oder null wenn keine Daten in diesem Format gefunden werden können.

Hinweis

Eine Implementierung dieser Methode finden Sie unter DataObject.GetData.

Weitere Informationen

Gilt für:

Freigeben über

IDataObject.GetData Methode

Definition

Überlädt

GetData(String)

Parameter

Gibt zurück

Beispiele

Hinweise

Weitere Informationen

Gilt für:

GetData(Type)

Parameter

Gibt zurück

Beispiele

Hinweise

Weitere Informationen

Gilt für:

GetData(String, Boolean)

Parameter

Gibt zurück

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Zusätzliche Ressourcen