IDataObject.GetData 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.

Mengambil data yang terkait dengan format data yang ditentukan.

Overload

Nama	Deskripsi
GetData(String)	Mengambil data yang terkait dengan format data yang ditentukan.
GetData(Type)	Mengambil data yang terkait dengan format jenis kelas yang ditentukan.
GetData(String, Boolean)	Mengambil data yang terkait dengan format data yang ditentukan, menggunakan Boolean untuk menentukan apakah akan mengonversi data ke format.

GetData(String)

Sumber:: IDataObject.cs

Sumber:: IDataObject.cs

Sumber:: IDataObject.cs

Sumber:: IDataObject.cs

Sumber:: IDataObject.cs

Mengambil data yang terkait dengan format data yang ditentukan.

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

public object GetData(string format);

public object? GetData(string format);

abstract member GetData : string -> obj

Public Function GetData (format As String) As Object

Parameter

format: String

Format data yang akan diambil. Lihat DataFormats untuk format yang telah ditentukan sebelumnya.

Mengembalikan

Object

Data yang terkait dengan format yang ditentukan, atau null.

Contoh

Contoh ini menggunakan DataObject kelas , yang mengimplementasikan IDataObject, untuk menunjukkan penggunaan GetData metode . Metode ini digunakan untuk mengambil data yang disimpan di myDataObject, yang terkait dengan Text format . Contoh mengasumsikan bahwa Anda telah membuat Form bernama Form1 dan bernama TextBoxtextBox1.

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

Keterangan

Jika metode ini tidak dapat menemukan data dalam format yang ditentukan, metode ini mencoba mengonversi data ke format . Jika data tidak dapat dikonversi ke format yang ditentukan, metode ini mengembalikan null.

Untuk menentukan apakah data dikaitkan dengan, atau dapat dikonversi ke, format, panggil GetDataPresent sebelum memanggil GetData. Panggil GetFormats daftar format yang valid untuk data yang disimpan dalam instans ini.

Note

Data dapat dikonversi ke format lain jika disimpan yang menentukan bahwa konversi diizinkan, dan jika format yang diminta kompatibel dengan format tersimpan. Misalnya, data yang disimpan sebagai Unicode dapat dikonversi ke teks.

Untuk implementasi metode ini, lihat DataObject.GetData.

Lihat juga

Berlaku untuk

GetData(Type)

Sumber:: IDataObject.cs

Sumber:: IDataObject.cs

Sumber:: IDataObject.cs

Sumber:: IDataObject.cs

Sumber:: IDataObject.cs

Mengambil data yang terkait dengan format jenis kelas yang ditentukan.

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

public 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

mewakili Type format data yang akan diambil. Lihat DataFormats untuk format yang telah ditentukan sebelumnya.

Mengembalikan

Object

Data yang terkait dengan format yang ditentukan, atau null.

Contoh

Contoh ini menggunakan DataObject kelas , yang mengimplementasikan IDataObject, untuk menunjukkan penggunaan GetData metode . Metode ini digunakan untuk mengambil data yang disimpan di myObject, yang terkait dengan jenis tertentu, myType. Jenis data yang diambil ditampilkan dalam kotak pesan. Contoh mengasumsikan bahwa Anda telah membuat bernama FormForm1.

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

Keterangan

Note

Untuk implementasi metode ini, lihat DataObject.GetData.

Lihat juga

Berlaku untuk

GetData(String, Boolean)

Sumber:: IDataObject.cs

Sumber:: IDataObject.cs

Sumber:: IDataObject.cs

Sumber:: IDataObject.cs

Sumber:: IDataObject.cs

Mengambil data yang terkait dengan format data yang ditentukan, menggunakan Boolean untuk menentukan apakah akan mengonversi data ke format.

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

public object GetData(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

Format data yang akan diambil. Lihat DataFormats untuk format yang telah ditentukan sebelumnya.

autoConvert: Boolean

true untuk mengonversi data ke format yang ditentukan; jika tidak, false.

Mengembalikan

Object

Data yang terkait dengan format yang ditentukan, atau null.

Contoh

Contoh ini menggunakan DataObject kelas , yang mengimplementasikan IDataObject, untuk menunjukkan penggunaan GetData metode . Contoh mengambil data yang disimpan dalam DataObject, menggunakan autoConvert parameter untuk menentukan apakah akan mengonversi format data atau tidak. Pertama, myDataObject dibuat dengan data teks. Kemudian contoh mencoba dua kali untuk mengambil data. Dalam uji coba pertama, ia menentukan formatnya sebagai string dan mengatur autoConvert parameter ke false. Uji coba ini gagal, dan hasilnya ditampilkan dalam kotak pesan berlabel "Pesan #1." Dalam uji coba kedua, contoh mengambil data yang sama dengan parameter yang autoConvert diatur ke true. Uji coba ini berhasil, dan hasilnya ditampilkan dalam kotak pesan berlabel "Pesan #2." Contoh mengasumsikan bahwa Anda telah membuat bernama FormForm1.

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

Keterangan

autoConvert Jika parameter adalah true dan metode ini tidak dapat menemukan data dalam format yang ditentukan, ia mencoba mengonversi data ke format . Jika data tidak dapat dikonversi ke format yang ditentukan, atau jika data disimpan dengan parameter yang autoConvert diatur ke false, metode ini mengembalikan null.

autoConvert Jika parameternya adalah false, metode ini mengembalikan data dalam format yang ditentukan, atau null jika tidak ada data dalam format ini yang dapat ditemukan.

Note

Untuk implementasi metode ini, lihat DataObject.GetData.

Lihat juga

Berlaku untuk

Saran dan Komentar

Apakah halaman ini membantu?