IDataObject.SetData Metode

Definisi

Ruang nama:: System.Windows.Forms

Rakitan:: System.Windows.Forms.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menyimpan data yang ditentukan dan format terkait dalam instans ini.

Overload

Nama	Deskripsi
SetData(Object)	Menyimpan data yang ditentukan dalam instans ini, menggunakan kelas data untuk format tersebut.
SetData(String, Object)	Menyimpan data yang ditentukan dan format terkait dalam instans ini.
SetData(Type, Object)	Menyimpan data yang ditentukan dan jenis kelas terkait dalam instans ini.
SetData(String, Boolean, Object)	Menyimpan data yang ditentukan dan format terkait dalam instans ini, menggunakan nilai Boolean untuk menentukan apakah data dapat dikonversi ke format lain.

SetData(Object)

Sumber:: IDataObject.cs

Sumber:: IDataObject.cs

Sumber:: IDataObject.cs

Sumber:: IDataObject.cs

Sumber:: IDataObject.cs

Menyimpan data yang ditentukan dalam instans ini, menggunakan kelas data untuk format tersebut.

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

Data yang akan disimpan.

Contoh

Contoh ini menggunakan DataObject kelas , yang mengimplementasikan IDataObject, untuk menunjukkan penggunaan SetData metode . Pertama, ia membuat komponen (myComponent) dan menyimpannya dalam objek data (myDataObject). Kemudian memeriksa apakah data yang ditentukan disimpan dalam objek data, dan menampilkan hasilnya dalam kotak pesan. Contoh mengasumsikan bahwa Anda telah membuat bernama FormForm1.

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

Keterangan

Format berasal dari kelas data.

Data yang disimpan menggunakan metode ini dapat dikonversi ke format yang kompatibel saat diambil.

Untuk implementasi metode ini, lihat DataObject.SetData.

Lihat juga

Berlaku untuk

SetData(String, Object)

Sumber:: IDataObject.cs

Sumber:: IDataObject.cs

Sumber:: IDataObject.cs

Sumber:: IDataObject.cs

Sumber:: IDataObject.cs

Menyimpan data yang ditentukan dan format terkait dalam instans ini.

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

Format yang terkait dengan data. Lihat DataFormats untuk format yang telah ditentukan sebelumnya.

data: Object

Data yang akan disimpan.

Contoh

Contoh ini menggunakan DataObject kelas , yang mengimplementasikan IDataObject, untuk menunjukkan penggunaan SetData metode . Pertama, ia membuat objek data (myDataObject) dan menyimpan string dalam objek yang UnicodeText menentukan format. Kemudian mengambil data yang disimpan dalam objek yang menentukan Text format, sehingga data dikonversi ke Text format. Hasilnya ditampilkan dalam kotak pesan. Contoh ini mengasumsikan bahwa Anda telah membuat bernama FormForm1.

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

Keterangan

Jika Anda tidak tahu format aplikasi target, Anda dapat menyimpan data dalam beberapa format menggunakan metode ini.

Data yang disimpan menggunakan metode ini dapat dikonversi ke format yang kompatibel saat diambil.

Untuk implementasi metode ini, lihat DataObject.SetData.

Lihat juga

Berlaku untuk

SetData(Type, Object)

Sumber:: IDataObject.cs

Sumber:: IDataObject.cs

Sumber:: IDataObject.cs

Sumber:: IDataObject.cs

Sumber:: IDataObject.cs

Menyimpan data yang ditentukan dan jenis kelas terkait dalam instans ini.

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

mewakili Type format yang terkait dengan data. Lihat DataFormats untuk format yang telah ditentukan sebelumnya.

data: Object

Data yang akan disimpan.

Contoh

Contoh ini menggunakan DataObject kelas , yang mengimplementasikan IDataObject, untuk menunjukkan penggunaan SetData metode . Pertama, ia membuat komponen (myComponent) dan menyimpannya dalam objek data (myDataObject), menggunakan myType untuk menentukan format data. Kemudian memeriksa apakah data jenis yang ditentukan disimpan dalam objek, dan menampilkan hasilnya dalam kotak pesan. Contoh mengasumsikan bahwa Anda telah membuat bernama FormForm1.

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

Keterangan

Jika Anda tidak tahu format aplikasi target, Anda dapat menyimpan data dalam beberapa format menggunakan metode ini.

Data yang disimpan menggunakan metode ini dapat dikonversi ke format yang kompatibel saat diambil.

Untuk implementasi metode ini, lihat DataObject.SetData.

Lihat juga

Berlaku untuk

SetData(String, Boolean, Object)

Sumber:: IDataObject.cs

Sumber:: IDataObject.cs

Sumber:: IDataObject.cs

Sumber:: IDataObject.cs

Sumber:: IDataObject.cs

Menyimpan data yang ditentukan dan format terkait dalam instans ini, menggunakan nilai Boolean untuk menentukan apakah data dapat dikonversi ke format lain.

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

Format yang terkait dengan data. Lihat DataFormats untuk format yang telah ditentukan sebelumnya.

autoConvert: Boolean

true untuk memungkinkan data dikonversi ke format lain; jika tidak, false.

data: Object

Data yang akan disimpan.

Contoh

Contoh ini menggunakan DataObject kelas , yang mengimplementasikan IDataObject, untuk menunjukkan penggunaan SetData metode . Pertama, ia membuat objek data (myDataObject) dan menyimpan UnicodeText string di dalamnya, dengan parameter diatur autoConvert ke false. Kemudian mengambil format yang terkait dengan data yang disimpan dalam objek dan menampilkan hasilnya dalam kotak pesan. Satu-satunya format yang terkait dengan data adalah formatnya UnicodeText . Contoh ini mengasumsikan bahwa Anda telah membuat bernama FormForm1.

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

Keterangan

Jika Anda tidak tahu format aplikasi target, Anda dapat menyimpan data dalam beberapa format menggunakan metode ini.

Untuk implementasi metode ini, lihat DataObject.SetData.

Lihat juga

Berlaku untuk

Saran dan Komentar

Apakah halaman ini membantu?