IDataObject.GetData Methode

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

Gibt zurück

Die mit dem angegebenen Format verknüpften Daten oder null.

Beispiele

In diesem Beispiel wird die DataObject Klasse verwendet, die implementiert IDataObject, wird, um die Verwendung der GetData Methode zu veranschaulichen. Die Methode wird verwendet, um die im myDataObjectFormat gespeicherten Daten abzurufen, die dem Text Format zugeordnet sind. Im Beispiel wird davon ausgegangen, dass Sie bereits einen Form Benannten Form1 und einen TextBox Benannten 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 ermitteln, ob Daten mit einem Format, einem Aufruf vor dem Aufrufen GetDataPresentGetDataverknüpft oder konvertiert werden können. Rufen Sie GetFormats eine Liste gültiger Formate für die in dieser Instanz gespeicherten Daten auf.

Eine Implementierung dieser Methode finden Sie unter DataObject.GetData.

Weitere Informationen

• SetData(String, Boolean, Object)
• GetDataPresent(String, Boolean)
• DataFormats
• GetFormats(Boolean)
• SetData(String, Boolean, Object)
• GetDataPresent(Type)
• GetFormats(Boolean)

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

Gibt zurück

Die mit dem angegebenen Format verknüpften Daten oder null.

Beispiele

In diesem Beispiel wird die DataObject Klasse verwendet, die implementiert IDataObjectwird, um die Verwendung der GetData Methode zu veranschaulichen. Die Methode wird verwendet, um die gespeicherten myObjectDaten 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 benannten Namen 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

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 ermitteln, ob Daten mit einem Format, einem Aufruf vor dem Aufrufen GetDataPresentGetDataverknüpft oder konvertiert werden können. Rufen Sie GetFormats eine Liste gültiger Formate für die in dieser Instanz gespeicherten Daten auf.

Eine Implementierung dieser Methode finden Sie unter DataObject.GetData.

Weitere Informationen

• SetData(String, Boolean, Object)
• GetDataPresent(String, Boolean)
• DataFormats
• GetFormats(Boolean)
• SetData(String, Boolean, Object)
• GetDataPresent(Type)
• GetFormats(Boolean)

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

Gibt zurück

Die mit dem angegebenen Format verknüpften Daten oder null.

Beispiele

In diesem Beispiel wird die DataObject Klasse verwendet, die implementiert IDataObjectwird, um die Verwendung der GetData Methode zu veranschaulichen. Im Beispiel werden die in einer DataObjectDatei gespeicherten Daten mithilfe des autoConvert Parameters abgerufen, um anzugeben, ob das Datenformat konvertiert werden soll. myDataObject Zuerst wird mit Textdaten erstellt. Anschließend versucht das Beispiel zweimal, die Daten abzurufen. In der ersten Testversion gibt sie das Format als Zeichenfolge an und legt den autoConvert Parameter auf false. Diese Testversion schlägt fehl, und das Ergebnis wird in einem Meldungsfeld mit der Bezeichnung "Nachricht #1" angezeigt. In der zweiten Testversion ruft das Beispiel dieselben Daten ab, für die der autoConvert Parameter festgelegt ist true. 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 benannten 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 und true 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 Parameter gespeichert wurden, auf falseden autoConvert der Parameter festgelegt ist, gibt diese Methode zurücknull.

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

Um zu ermitteln, ob Daten mit einem Format, einem Aufruf vor dem Aufrufen GetDataPresentGetDataverknüpft oder konvertiert werden können. Rufen Sie GetFormats eine Liste gültiger Formate für die in dieser Instanz gespeicherten Daten auf.

Eine Implementierung dieser Methode finden Sie unter DataObject.GetData.

Weitere Informationen

• SetData(String, Boolean, Object)
• GetDataPresent(String, Boolean)
• DataFormats
• GetFormats(Boolean)
• SetData(String, Boolean, Object)
• GetDataPresent(Type)
• GetFormats(Boolean)