IDataObject.GetData Methode

Definition

Ruft die Daten ab, die dem angegebenen Datenformat zugeordnet sind.Retrieves the data associated with the specified data format.

Überlädt

GetData(String)

Ruft die Daten ab, die dem angegebenen Datenformat zugeordnet sind.Retrieves the data associated with the specified data format.

GetData(Type)

Ruft die Daten ab, die dem angegebenen Format für den Klassentyp zugeordnet sind.Retrieves the data associated with the specified class type format.

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.Retrieves the data associated with the specified data format, using a Boolean to determine whether to convert the data to the format.

GetData(String)

Ruft die Daten ab, die dem angegebenen Datenformat zugeordnet sind.Retrieves the data associated with the specified data format.

public:
 System::Object ^ GetData(System::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.The format of the data to retrieve. Vordefinierte Formate finden Sie unter DataFormats.See DataFormats for predefined formats.

Gibt zurück

Object

Die dem angegebenen Format zugeordneten Daten oder null.The data associated with the specified format, or null.

Beispiele

In diesem Beispiel wird die- DataObject Klasse verwendet, die implementiert, IDataObject, um die Verwendung der-Methode zu veranschaulichen GetData .This example uses the DataObject class, which implements IDataObject, to demonstrate the use of the GetData method. Die-Methode wird verwendet, um die in gespeicherten Daten abzurufen myDataObject , die dem- Text Format zugeordnet sind.The method is used to retrieve the data stored in myDataObject, which is associated with the Text format. Im Beispiel wird davon ausgegangen, dass Sie bereits einen mit Form Form1 dem Namen und ein mit dem TextBox Namen textBox1 erstellt habenThe example assumes that you have already created a Form named Form1 and a TextBox named 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

Hinweise

Wenn diese Methode keine Daten im angegebenen Format finden kann, wird versucht, die Daten in das-Format zu konvertieren.If this method cannot find data in the specified format, it attempts to convert the data to the format. Wenn die Daten nicht in das angegebene Format konvertiert werden können, gibt diese Methode zurück null .If the data cannot be converted to the specified format, this method returns null.

Um zu ermitteln, ob Daten einem Format zugeordnet sind oder in dieses konvertiert werden können, rufen Sie vor dem Aufruf von auf GetDataPresent GetData .To determine whether data is associated with, or can be converted to, a format, call GetDataPresent before calling GetData. Ruft GetFormats eine Liste gültiger Formate für die in dieser Instanz gespeicherten Daten auf.Call GetFormats for a list of valid formats for the data stored in this instance.

Hinweis

Daten können in ein anderes Format konvertiert werden, wenn Sie gespeichert wurden und angeben, dass die Konvertierung zulässig ist, und wenn das angeforderte Format mit dem gespeicherten Format kompatibel ist.Data can be converted to another format if it was stored specifying that conversion is allowed, and if the requested format is compatible with the stored format. Beispielsweise können Daten, die als Unicode gespeichert werden, in Text konvertiert werden.For example, data stored as Unicode can be converted to text.

Eine Implementierung dieser Methode finden Sie unter DataObject.GetData .For an implementation of this method, see DataObject.GetData.

Siehe auch

Gilt für:

GetData(Type)

Ruft die Daten ab, die dem angegebenen Format für den Klassentyp zugeordnet sind.Retrieves the data associated with the specified class type format.

public:
 System::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.A Type representing the format of the data to retrieve. Vordefinierte Formate finden Sie unter DataFormats.See DataFormats for predefined formats.

Gibt zurück

Object

Die dem angegebenen Format zugeordneten Daten oder null.The data associated with the specified format, or null.

Beispiele

In diesem Beispiel wird die- DataObject Klasse, die implementiert, verwendet, IDataObject um die Verwendung der-Methode zu veranschaulichen GetData .This example uses the DataObject class, which implements IDataObject, to demonstrate the use of the GetData method. Die-Methode wird verwendet, um die in gespeicherten Daten abzurufen myObject , die mit einem bestimmten Typ verknüpft sind myType .The method is used to retrieve the data stored in myObject, which is associated with a specific type, myType. Der Typ der abgerufenen Daten wird in einem Meldungs Feld angezeigt.The type of the retrieved data is displayed in a message box. Im Beispiel wird davon ausgegangen, dass Sie bereits einen mit dem Namen erstellt haben Form Form1 .The example assumes that you have already created a Form named 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

Hinweise

Wenn diese Methode keine Daten im angegebenen Format finden kann, wird versucht, die Daten in das-Format zu konvertieren.If this method cannot find data in the specified format, it attempts to convert the data to the format. Wenn die Daten nicht in das angegebene Format konvertiert werden können, gibt diese Methode zurück null .If the data cannot be converted to the specified format, this method returns null.

Um zu ermitteln, ob Daten einem Format zugeordnet sind oder in dieses konvertiert werden können, rufen Sie vor dem Aufruf von auf GetDataPresent GetData .To determine whether data is associated with, or can be converted to, a format, call GetDataPresent before calling GetData. Ruft GetFormats eine Liste gültiger Formate für die in dieser Instanz gespeicherten Daten auf.Call GetFormats for a list of valid formats for the data stored in this instance.

Hinweis

Daten können in ein anderes Format konvertiert werden, wenn Sie gespeichert wurden und angeben, dass die Konvertierung zulässig ist, und wenn das angeforderte Format mit dem gespeicherten Format kompatibel ist.Data can be converted to another format if it was stored specifying that conversion is allowed, and if the requested format is compatible with the stored format. Beispielsweise können Daten, die als Unicode gespeichert werden, in Text konvertiert werden.For example, data stored as Unicode can be converted to text.

Eine Implementierung dieser Methode finden Sie unter DataObject.GetData .For an implementation of this method, see DataObject.GetData.

Siehe auch

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.Retrieves the data associated with the specified data format, using a Boolean to determine whether to convert the data to the format.

public:
 System::Object ^ GetData(System::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.The format of the data to retrieve. Vordefinierte Formate finden Sie unter DataFormats.See DataFormats for predefined formats.

autoConvert
Boolean

true, wenn die Daten in das angegebene Format konvertiert werden sollen, andernfalls false.true to convert the data to the specified format; otherwise, false.

Gibt zurück

Object

Die dem angegebenen Format zugeordneten Daten oder null.The data associated with the specified format, or null.

Beispiele

In diesem Beispiel wird die- DataObject Klasse, die implementiert, verwendet, IDataObject um die Verwendung der-Methode zu veranschaulichen GetData .This example uses the DataObject class, which implements IDataObject, to demonstrate the use of the GetData method. Im Beispiel werden die in einem gespeicherten Daten abgerufen DataObject , wobei der-Parameter verwendet wird, autoConvert um anzugeben, ob das Datenformat konvertiert werden soll.The example retrieves the data stored in a DataObject, using the autoConvert parameter to specify whether or not to convert the data format. Zuerst myDataObject wird mit Textdaten erstellt.First, myDataObject is created with text data. Anschließend wird im Beispiel zweimal versucht, die Daten abzurufen.Then the example tries twice to retrieve the data. In der ersten Testversion wird das Format als Zeichenfolge angegeben, und der-Parameter wird auf festgelegt autoConvert false .In the first trial, it specifies its format as a string and sets the autoConvert parameter to false. Diese Testversion schlägt fehl, und das Ergebnis wird in einem Meldungs Feld mit der Bezeichnung "Message #1" angezeigt.This trial fails, and the result is displayed in a message box labeled "Message #1." In der zweiten Testversion Ruft das Beispiel dieselben Daten ab, wobei der- autoConvert Parameter auf festgelegt ist true .In the second trial, the example retrieves the same data with the autoConvert parameter set to true. Diese Testversion ist erfolgreich, und das Ergebnis wird in einem Meldungs Feld mit der Bezeichnung "Message #2" angezeigt.This trial succeeds, and the result is displayed in a message box labeled "Message #2." Im Beispiel wird davon ausgegangen, dass Sie einen mit dem Namen erstellt haben Form Form1 .The example assumes that you have created a Form named 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

Hinweise

Wenn der autoConvert -Parameter ist true und diese Methode keine Daten im angegebenen Format finden kann, wird versucht, die Daten in das-Format zu konvertieren.If the autoConvert parameter is true and this method cannot find data in the specified format, it attempts to convert the data to the format. Wenn die Daten nicht in das angegebene Format konvertiert werden können oder wenn die Daten mit dem autoConvert auf festgelegten-Parameter gespeichert wurden false , gibt diese Methode zurück null .If the data cannot be converted to the specified format, or if the data was stored with the autoConvert parameter set to false, this method returns 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.If the autoConvert parameter is false, this method returns data in the specified format, or null if no data in this format can be found.

Um zu ermitteln, ob Daten einem Format zugeordnet sind oder in dieses konvertiert werden können, rufen Sie vor dem Aufruf von auf GetDataPresent GetData .To determine whether data is associated with, or can be converted to, a format, call GetDataPresent before calling GetData. Ruft GetFormats eine Liste gültiger Formate für die in dieser Instanz gespeicherten Daten auf.Call GetFormats for a list of valid formats for the data stored in this instance.

Hinweis

Daten können in ein anderes Format konvertiert werden, wenn Sie gespeichert wurden und angeben, dass die Konvertierung zulässig ist, und wenn das angeforderte Format mit dem gespeicherten Format kompatibel ist.Data can be converted to another format if it was stored specifying that conversion is allowed, and if the requested format is compatible with the stored format. Beispielsweise können Daten, die als Unicode gespeichert werden, in Text konvertiert werden.For example, data stored as Unicode can be converted to text.

Eine Implementierung dieser Methode finden Sie unter DataObject.GetData .For an implementation of this method, see DataObject.GetData.

Siehe auch

Gilt für: