IDataObject.SetData Methode

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.

Speichert die angegebenen Daten und das zugehörige Format in dieser Instanz.

Überlädt

Name	Beschreibung
SetData(Object)	Speichert die angegebenen Daten in dieser Instanz mithilfe der Klasse der Daten für das Format.
SetData(String, Object)	Speichert die angegebenen Daten und das zugehörige Format in dieser Instanz.
SetData(Type, Object)	Speichert die angegebenen Daten und den zugehörigen Klassentyp in dieser Instanz.
SetData(String, Boolean, Object)	Speichert die angegebenen Daten und das zugehörige Format in dieser Instanz mithilfe eines booleschen Werts, um anzugeben, ob die Daten in ein anderes Format konvertiert werden können.

SetData(Object)

Quelle:: IDataObject.cs

Quelle:: IDataObject.cs

Quelle:: IDataObject.cs

Quelle:: IDataObject.cs

Quelle:: IDataObject.cs

Speichert die angegebenen Daten in dieser Instanz mithilfe der Klasse der Daten für das Format.

public:
 void SetData(System::Object ^ data);

public void SetData(object data);

public void SetData(object? data);

abstract member SetData : obj -> unit

Public Sub SetData (data As Object)

Parameter

data: Object

Die zu speichernden Daten.

Beispiele

In diesem Beispiel wird die DataObject Klasse verwendet, die implementiert IDataObjectwird, um die Verwendung der SetData Methode zu veranschaulichen. Zunächst wird eine Komponente (myComponent) erstellt und in einem Datenobjekt (myDataObject) gespeichert. Anschließend wird überprüft, ob die angegebenen Daten im Datenobjekt gespeichert sind, und zeigt das Ergebnis in einem Meldungsfeld an. Im Beispiel wird davon ausgegangen, dass Sie einen Form benannten Namen Form1erstellt haben.

private:
   void SetData1()
   {
      // Creates a component to store in the data object.
      Component^ myComponent = gcnew Component;
      
      // Creates a data object.
      DataObject^ myDataObject = gcnew DataObject;
      
      // Adds the component to the data object.
      myDataObject->SetData( myComponent );
      
      // Checks whether data of the specified type is in the data object.
      Type^ myType = myComponent->GetType();
      String^ myMessageText;
      if ( myDataObject->GetDataPresent( myType ) )
      {
         myMessageText = "Data of type " + myType->Name +
            " is present in the data object";
      }
      else
      {
         myMessageText = "Data of type " + myType->Name +
            " is not present in the data object";
      }
      
      // Displays the result in a message box.
      MessageBox::Show( myMessageText, "The Test Result" );
   }

private void SetData1() 
{
    // Creates a component to store in the data object.
    Component myComponent = new Component();
 
    // Creates a data object.
    DataObject myDataObject = new DataObject();

    // Adds the component to the data object.
    myDataObject.SetData(myComponent);
 
    // Checks whether data of the specified type is in the data object.
    Type myType = myComponent.GetType();
    string myMessageText;
    if(myDataObject.GetDataPresent(myType))
         myMessageText = "Data of type " + myType.Name + 
            " is present in the data object";
    else
        myMessageText = "Data of type " + myType.Name +
            " is not present in the data object";

    // Displays the result in a message box.
    MessageBox.Show(myMessageText, "The Test Result"); 
}

Private Sub SetData1()
   ' Creates a component to store in the data object.
   Dim myComponent As New System.ComponentModel.Component()
   
   ' Creates a data object.
   Dim myDataObject As New DataObject()
   
   ' Adds the component to the data object.
   myDataObject.SetData(myComponent)
   
   ' Checks whether data of the specified type is in the data object.
   Dim myType As Type = myComponent.GetType()
   Dim myMessageText As String
   If myDataObject.GetDataPresent(myType) Then
      myMessageText = "Data of type " + myType.Name + " is present in the data object"
   Else
      myMessageText = "Data of type " + myType.Name + " is not present in the data object"
   End If

   ' Displays the result in a message box.
   MessageBox.Show(myMessageText, "The Test Result")
End Sub

Hinweise

Das Format wird von der Datenklasse abgeleitet.

Mit dieser Methode gespeicherte Daten können beim Abrufen in ein kompatibles Format konvertiert werden.

Eine Implementierung dieser Methode finden Sie unter DataObject.SetData.

Weitere Informationen

Gilt für:

SetData(String, Object)

Quelle:: IDataObject.cs

Quelle:: IDataObject.cs

Quelle:: IDataObject.cs

Quelle:: IDataObject.cs

Quelle:: IDataObject.cs

Speichert die angegebenen Daten und das zugehörige Format in dieser Instanz.

public:
 void SetData(System::String ^ format, System::Object ^ data);

public void SetData(string format, object data);

public void SetData(string format, object? data);

abstract member SetData : string * obj -> unit

Public Sub SetData (format As String, data As Object)

Parameter

format: String

Das format, das den Daten zugeordnet ist. Informationen zu vordefinierten Formaten finden Sie DataFormats unter

data: Object

Die zu speichernden Daten.

Beispiele

In diesem Beispiel wird die DataObject Klasse verwendet, die implementiert IDataObjectwird, um die Verwendung der SetData Methode zu veranschaulichen. Zunächst wird ein Datenobjekt (myDataObject) erstellt und eine Zeichenfolge im Objekt gespeichert, die das UnicodeText Format angibt. Anschließend werden die im Objekt gespeicherten Daten abgerufen, die das Text Format angeben, sodass die Daten in das Text Format konvertiert werden. Das Ergebnis wird in einem Meldungsfeld angezeigt. In diesem Beispiel wird davon ausgegangen, dass Sie einen Form benannten Namen Form1erstellt haben.

private:
   void SetData2()
   {
      // Creates a data object.
      DataObject^ myDataObject = gcnew DataObject;
      
      // Stores a string, specifying the UnicodeText format.
      myDataObject->SetData( DataFormats::UnicodeText, "Hello World!" );
      
      // Retrieves the data by specifying the Text format.
      String^ myMessageText = "The data type is " +
         myDataObject->GetData( DataFormats::Text )->GetType()->Name;
      
      // Displays the result.
      MessageBox::Show( myMessageText, "The Test Result" );
   }

private void SetData2() 
{
    // Creates a data object.
    DataObject myDataObject = new DataObject();
 
    // Stores a string, specifying the UnicodeText format.
    myDataObject.SetData(DataFormats.UnicodeText, "Hello World!");
 
    // Retrieves the data by specifying the Text format.
    string myMessageText = "The data type is " + myDataObject.GetData(DataFormats.Text).GetType().Name;

    // Displays the result.
    MessageBox.Show(myMessageText, "The Test Result");
}

Private Sub SetData2()
   ' Creates a data object.
   Dim myDataObject As New DataObject()
   
   ' Stores a string, specifying the UnicodeText format.
   myDataObject.SetData(DataFormats.UnicodeText, "Hello World!")
   
   ' Retrieves the data by specifying the Text format.
   Dim myMessageText As String = "The data type is " & _
             myDataObject.GetData(DataFormats.Text).GetType().Name
   
   ' Displays the result.
   MessageBox.Show(myMessageText, "The Test Result")
End Sub

Hinweise

Wenn Sie das Format der Zielanwendung nicht kennen, können Sie Daten mithilfe dieser Methode in mehreren Formaten speichern.

Mit dieser Methode gespeicherte Daten können beim Abrufen in ein kompatibles Format konvertiert werden.

Eine Implementierung dieser Methode finden Sie unter DataObject.SetData.

Weitere Informationen

Gilt für:

SetData(Type, Object)

Quelle:: IDataObject.cs

Quelle:: IDataObject.cs

Quelle:: IDataObject.cs

Quelle:: IDataObject.cs

Quelle:: IDataObject.cs

Speichert die angegebenen Daten und den zugehörigen Klassentyp in dieser Instanz.

public:
 void SetData(Type ^ format, System::Object ^ data);

public void SetData(Type format, object data);

public void SetData(Type format, object? data);

abstract member SetData : Type * obj -> unit

Public Sub SetData (format As Type, data As Object)

Parameter

format: Type

A Type representing the format associated with the data. Informationen zu vordefinierten Formaten finden Sie DataFormats unter

data: Object

Die zu speichernden Daten.

Beispiele

In diesem Beispiel wird die DataObject Klasse verwendet, die implementiert IDataObjectwird, um die Verwendung der SetData Methode zu veranschaulichen. Zunächst wird eine Komponente (myComponent) erstellt und in einem Datenobjekt (myDataObject) gespeichert, wobei myType das Datenformat angegeben wird. Anschließend wird überprüft, ob die Daten des angegebenen Typs im Objekt gespeichert sind, und zeigt das Ergebnis in einem Meldungsfeld an. Im Beispiel wird davon ausgegangen, dass Sie einen Form benannten Namen Form1erstellt haben.

private:
   void SetData3()
   {
      // Creates a component.
      Component^ myComponent = gcnew Component;
      
      // Gets the type of the component.
      Type^ myType = myComponent->GetType();
      
      // Creates a data object.
      DataObject^ myDataObject = gcnew DataObject;
      
      // Stores the component in the data object.
      myDataObject->SetData( myType, myComponent );
      
      // Checks whether data of the specified type is in the data object.
      String^ myMessageText;
      if ( myDataObject->GetDataPresent( myType ) )
      {
         myMessageText = "Data of type " + myType->Name +
            " is stored in the data object";
      }
      else
      {
         myMessageText = "No data of type " + myType->Name +
            " is stored in the data object";
      }
      
      // Displays the result.
      MessageBox::Show( myMessageText, "The Test Result" );
   }

private void SetData3() 
{
    // Creates a component.
    Component myComponent = new Component();
 
    // Gets the type of the component.
    Type myType = myComponent.GetType();
 
    // Creates a data object.
    DataObject myDataObject = new DataObject();
 
    // Stores the component in the data object.
    myDataObject.SetData(myType, myComponent);
 
    // Checks whether data of the specified type is in the data object.
    string myMessageText;
    if(myDataObject.GetDataPresent(myType))
        myMessageText = "Data of type " + myType.Name + 
            " is stored in the data object";
    else
        myMessageText = "No data of type " + myType.Name +
            " is stored in the data object";
            
    // Displays the result.
    MessageBox.Show(myMessageText, "The Test Result");
}

Private Sub SetData3()
   ' Creates a component.
   Dim myComponent As New System.ComponentModel.Component()
   
   ' Gets the type of the component.
   Dim myType As Type = myComponent.GetType()
   
   ' Creates a data object.
   Dim myDataObject As New DataObject()
   
   ' Stores the component in the data object.
   myDataObject.SetData(myType, myComponent)
   
   ' Checks whether data of the specified type is in the data object.
   Dim myMessageText As String
   If myDataObject.GetDataPresent(myType) Then
      myMessageText = "Data of type " & myType.Name & " is stored in the data object"
   Else
      myMessageText = "No data of type " & myType.Name & " is stored in the data object"
   End If
   
   ' Displays the result.
   MessageBox.Show(myMessageText, "The Test Result")
End Sub

Hinweise

Wenn Sie das Format der Zielanwendung nicht kennen, können Sie Daten mithilfe dieser Methode in mehreren Formaten speichern.

Mit dieser Methode gespeicherte Daten können beim Abrufen in ein kompatibles Format konvertiert werden.

Eine Implementierung dieser Methode finden Sie unter DataObject.SetData.

Weitere Informationen

Gilt für:

SetData(String, Boolean, Object)

Quelle:: IDataObject.cs

Quelle:: IDataObject.cs

Quelle:: IDataObject.cs

Quelle:: IDataObject.cs

Quelle:: IDataObject.cs

Speichert die angegebenen Daten und das zugehörige Format in dieser Instanz mithilfe eines booleschen Werts, um anzugeben, ob die Daten in ein anderes Format konvertiert werden können.

public:
 void SetData(System::String ^ format, bool autoConvert, System::Object ^ data);

public void SetData(string format, bool autoConvert, object data);

public void SetData(string format, bool autoConvert, object? data);

abstract member SetData : string * bool * obj -> unit

Public Sub SetData (format As String, autoConvert As Boolean, data As Object)

Parameter

format: String

Das format, das den Daten zugeordnet ist. Informationen zu vordefinierten Formaten finden Sie DataFormats unter

autoConvert: Boolean

truedamit die Daten in ein anderes Format konvertiert werden können; andernfalls . false

data: Object

Die zu speichernden Daten.

Beispiele

In diesem Beispiel wird die DataObject Klasse verwendet, die implementiert IDataObjectwird, um die Verwendung der SetData Methode zu veranschaulichen. Zunächst wird ein Datenobjekt () erstellt und eine Zeichenfolge darin gespeichert, wobei der Parameter auf .a0> festgelegt ist. Anschließend ruft es die Format(en) ab, die den im Objekt gespeicherten Daten zugeordnet sind, und zeigt das Ergebnis in einem Meldungsfeld an. Das einzige Format, das den Daten zugeordnet ist, ist das UnicodeText Format. In diesem Beispiel wird davon ausgegangen, dass Sie einen Form benannten Namen Form1erstellt haben.

private:
   void SetData4()
   {
      // Creates a new data object.
      DataObject^ myDataObject = gcnew DataObject;

      // Adds UnicodeText string to the object, and set the autoConvert
      // parameter to false.
      myDataObject->SetData( DataFormats::UnicodeText, false, "My text String*" );

      // Gets the data format(s) in the data object.
      array<String^>^arrayOfFormats = myDataObject->GetFormats();

      // Stores the results in a string.
      String^ theResult = "The format(s) associated with the data are: \n";
      for ( int i = 0; i < arrayOfFormats->Length; i++ )
         theResult = theResult + arrayOfFormats[ i ], " \n";

      // Show the results in a message box.
      MessageBox::Show( theResult );
   }

       private void SetData4() 
       {
           // Creates a new data object.
           DataObject myDataObject = new DataObject();

           // Adds UnicodeText string to the object, and set the autoConvert 
           // parameter to false.
           myDataObject.SetData(DataFormats.UnicodeText, false, "My text string");

           // Gets the data format(s) in the data object.
           String[] arrayOfFormats = myDataObject.GetFormats();

           // Stores the results in a string.
           string theResult = "The format(s) associated with the data are:" + '\n';
           for(int i=0; i<arrayOfFormats.Length; i++)
               theResult += arrayOfFormats[i] + '\n';
           
           // Show the results in a message box. 
           MessageBox.Show(theResult);
       }

Private Sub SetData4()
    ' Creates a new data object.
    Dim myDataObject As New DataObject()

    ' Adds UnicodeText string to the object, and set the autoConvert
    ' parameter to false.
    myDataObject.SetData(DataFormats.UnicodeText, False, "My text string")

    ' Gets the data format(s) in the data object.
    Dim arrayOfFormats As [String]() = myDataObject.GetFormats()

    ' Stores the results in a string.
    Dim theResult As String = "The format(s) associated with the data are:" + _
            ControlChars.Cr
    Dim i As Integer
    For i = 0 To arrayOfFormats.Length - 1
        theResult += arrayOfFormats(i) + ControlChars.Cr
    Next i
    ' Show the results in a message box. 
    MessageBox.Show(theResult)
End Sub

Hinweise

Wenn Sie das Format der Zielanwendung nicht kennen, können Sie Daten mithilfe dieser Methode in mehreren Formaten speichern.

Eine Implementierung dieser Methode finden Sie unter DataObject.SetData.

Weitere Informationen

Gilt für:

Feedback

War diese Seite hilfreich?