DataObject.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.

Gibt die Daten zurück, die dem angegebenen Datenformat zugeordnet sind.

Überlädt

GetData(String, Boolean)	Gibt die dem angegebenen Datenformat zugeordneten Daten zurück. Dabei wird mithilfe eines Parameters für die automatische Konvertierung bestimmt, ob die Daten in das Format konvertiert werden sollen.
GetData(String)	Gibt die Daten zurück, die dem angegebenen Datenformat zugeordnet sind.
GetData(Type)	Gibt die Daten zurück, die dem für den Klassentyp angegebenen Format zugeordnet sind.

GetData(String, Boolean)

Gibt die dem angegebenen Datenformat zugeordneten Daten zurück. Dabei wird mithilfe eines Parameters für die automatische Konvertierung bestimmt, ob die Daten in das Format konvertiert werden sollen.

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

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

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

abstract member GetData : string * bool -> obj
override this.GetData : string * bool -> obj

Public Overridable 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.

Implementiert

GetData(String, Boolean)

Beispiele

Im folgenden Codebeispiel werden die in einem DataObjectgespeicherten Daten mithilfe des autoConvert Parameters abgerufen, um anzugeben, ob das Datenformat konvertiert werden soll.

Zunächst wird ein neues DataObject mit Textdaten erstellt. Anschließend versucht das Beispiel, die Daten abzurufen, wobei das Format als Zeichenfolge und keine Formatkonvertierung angegeben wird, d. h. der autoConvert Parameter ist false. Dieser Vorgang schlägt fehl, da keine Zeichenfolgendaten in enthalten DataObjectsind.

Als Nächstes versucht das Beispiel, die Daten erneut abzurufen, wobei der autoConvert Parameter auf truefestgelegt ist. Dieser Vorgang ist erfolgreich, und die Ergebnisse werden in einem MessageBoxangezeigt.

Dieser Code erfordert, dass textBox1 erstellt wurde.

private:
   void GetMyData3()
   {
      // Creates a new data object using a string and the text format.
      String^ myString = "My new text string";
      DataObject^ myDataObject = gcnew DataObject( DataFormats::Text,myString );
      
      // Prints the string in a text box with autoconvert = false.
      if ( myDataObject->GetData( "System.String", false ) != 0 )
      {
         // Prints the string in a text box.
         textBox1->Text = String::Concat(
            myDataObject->GetData( "System.String", false )->ToString(), "\n" );
      }
      else
      {
         textBox1->Text = "Could not find data of the specified format\n";
      }
      
      // Prints the string in a text box with autoconvert = true.
      textBox1->Text = String::Concat(
            textBox1->Text, myDataObject->GetData( "System.String", true )->ToString() );
   }

private void GetMyData3() {
    // Creates a new data object using a string and the text format.
    string myString = "My new text string";
    DataObject myDataObject = new DataObject(DataFormats.Text, myString);
 
    // Prints the string in a text box with autoconvert = false.
    if(myDataObject.GetData("System.String", false) != null) {
       // Prints the string in a text box.
       textBox1.Text = myDataObject.GetData("System.String", false).ToString() + '\n';
    } else
        {
            textBox1.Text = "Could not find data of the specified format" + '\n';
        }

        // Prints the string in a text box with autoconvert = true.
        textBox1.Text += myDataObject.GetData("System.String", true).ToString();
 }

Private Sub GetMyData3()
    ' Creates a new data object using a string and the text format.
    Dim myString As String = "My new text string"
    Dim myDataObject As New DataObject(DataFormats.Text, myString)
    
    ' Prints the string in a text box with autoconvert = false.
    If (myDataObject.GetData("System.String", False) IsNot Nothing) Then
        ' Prints the string in a text box.
        textBox1.Text = myDataObject.GetData("System.String", False).ToString() & ControlChars.Cr
    Else
        textBox1.Text = "Could not find data of the specified format" & ControlChars.Cr
    End If 
    ' Prints the string in a text box with autoconvert = true.
    textBox1.Text += myDataObject.GetData("System.String", True).ToString()
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 der automatischen Konvertierung falseauf gespeichert wurden, 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.

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 diesem DataObjectgespeicherten 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.

Wenn format ist, gibt Htmldiese Methode eine UTF-8-codierte Zeichenfolge in Anwendungen zurück, die auf .NET 4.5 oder höher abzielen, und eine ANSI-codierte Zeichenfolge in Anwendungen, die auf .NET 4.0 oder niedriger abzielen.

Weitere Informationen

Gilt für:

GetData(String)

Gibt die Daten zurück, die dem angegebenen Datenformat zugeordnet sind.

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

public virtual object GetData (string format);

public virtual object? GetData (string format);

abstract member GetData : string -> obj
override this.GetData : string -> obj

Public Overridable 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.

Implementiert

GetData(String)

Beispiele

Im folgenden Codebeispiel werden die in einem DataObjectgespeicherten Daten abgerufen. Zunächst wird ein neues DataObject mit Textdaten erstellt. Anschließend werden die Daten abgerufen, ihr Format als Zeichenfolge angegeben und in einem Textfeld angezeigt.

Dieser Code erfordert, dass textBox1 erstellt wurde.

private:
   void AddMyData3()
   {
      // Creates a component to store in the data object.
      Component^ myComponent = gcnew Component;
      
      // Creates a new data object.
      DataObject^ myDataObject = gcnew DataObject;
      
      // Adds the component to the DataObject.
      myDataObject->SetData( myComponent );
      
      // Prints whether data of the specified type is in the DataObject.
      Type^ myType = myComponent->GetType();
      if ( myDataObject->GetDataPresent( myType ) )
      {
         textBox1->Text = String::Concat( "Data of type ", myType,
            " is present in the DataObject" );
      }
      else
      {
         textBox1->Text = String::Concat( "Data of type ", myType,
            " is not present in the DataObject" );
      }
   }

private void AddMyData3() {
    // Creates a component to store in the data object.
    Component myComponent = new Component();
 
    // Creates a new data object.
    DataObject myDataObject = new DataObject();
 
    // Adds the component to the DataObject.
    myDataObject.SetData(myComponent);
 
    // Prints whether data of the specified type is in the DataObject.
    Type myType = myComponent.GetType();
    if(myDataObject.GetDataPresent(myType))
       textBox1.Text = "Data of type " + myType.ToString() + 
       " is present in the DataObject";
    else
       textBox1.Text = "Data of type " + myType.ToString() +
       " is not present in the DataObject";
 }

Private Sub AddMyData3()
    ' Creates a component to store in the data object.
    Dim myComponent As New Component()
    
    ' Creates a new data object.
    Dim myDataObject As New DataObject()
    
    ' Adds the component to the DataObject.
    myDataObject.SetData(myComponent)
    
    ' Prints whether data of the specified type is in the DataObject.
    Dim myType As Type = myComponent.GetType()
    If myDataObject.GetDataPresent(myType) Then
        textBox1.Text = "Data of type " & myType.ToString() & _
            " is present in the DataObject"
    Else
        textBox1.Text = "Data of type " & myType.ToString() & _
            " is not present in the DataObject"
    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 oder wenn die Daten mit der falseautomatischen Konvertierung auf gespeichert wurden, gibt diese Methode zurück null.

Hinweis

Weitere Informationen

Gilt für:

GetData(Type)

Gibt die Daten zurück, die dem für den Klassentyp angegebenen Format zugeordnet sind.

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

public virtual object GetData (Type format);

public virtual object? GetData (Type format);

abstract member GetData : Type -> obj
override this.GetData : Type -> obj

Public Overridable Function GetData (format As Type) As Object

Parameter

format: Type

Ein Type, das das Format der abzurufenden Daten darstellt.

Gibt zurück

Object

Die dem angegebenen Format zugeordneten Daten oder null.

Implementiert

GetData(Type)

Beispiele

Im folgenden Codebeispiel werden die in einem DataObjectgespeicherten Daten abgerufen. Zunächst wird ein neues DataObject mit einer Komponente erstellt. Anschließend werden die Daten abgerufen und geben ihren Typ an. Der Typ der abgerufenen Daten wird in einem Textfeld angezeigt.

Dieser Code erfordert, dass textBox1 erstellt wurde.

private:
   void GetMyData()
   {
      // Creates a component to store in the data object.
      Component^ myComponent = gcnew Component;
      
      // Creates a new data object and assigns it the component.
      DataObject^ myDataObject = gcnew DataObject( myComponent );
      
      // Creates a type 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 )
      {
         textBox1->Text = String::Format( "The data type stored in the DataObject is: {0}",
            myObject->GetType()->Name );
      }
      else
      {
         textBox1->Text = "Data of the specified type was not stored in the DataObject.";
      }
   }

private void GetMyData() {
    // Creates a component to store in the data object.
    Component myComponent = new Component();
 
    // Creates a new data object and assigns it the component.
    DataObject myDataObject = new DataObject(myComponent);
 
    // Creates a type 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)
       textBox1.Text = "The data type stored in the DataObject is: " +
       myObject.GetType().Name;
    else
       textBox1.Text = "Data of the specified type was not stored " +
       "in the DataObject.";
 }

Private Sub GetMyData()
    ' Creates a component to store in the data object.
    Dim myComponent As New Component()
    
    ' Creates a new data object and assigns it the component.
    Dim myDataObject As New DataObject(myComponent)
    
    ' Creates a type 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
        textBox1.Text = "The data type stored in the DataObject is: " & myObject.GetType().Name
    Else
        textBox1.Text = "Data of the specified type was not stored " & "in the DataObject."
    End If
End Sub

Hinweise

Hinweis

Weitere Informationen

Gilt für:

Freigeben über

DataObject.GetData Methode

Definition

Überlädt

GetData(String, Boolean)

Parameter

Gibt zurück

Implementiert

Beispiele

Hinweise

Weitere Informationen

Gilt für:

GetData(String)

Parameter

Gibt zurück

Implementiert

Beispiele

Hinweise

Weitere Informationen

Gilt für:

GetData(Type)

Parameter

Gibt zurück

Implementiert

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Zusätzliche Ressourcen