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

Mengembalikan daftar semua format yang disimpan data dalam instans ini dikaitkan dengan atau dapat dikonversi.

Overload

Nama	Deskripsi
GetFormats()	Mengembalikan daftar semua format yang disimpan data dalam instans ini dikaitkan dengan atau dapat dikonversi.
GetFormats(Boolean)	Mendapatkan daftar semua format yang disimpan data dalam instans ini dikaitkan dengan atau dapat dikonversi ke, menggunakan nilai Boolean untuk menentukan apakah akan mengambil semua format yang dapat dikonversi data ke atau hanya format data asli.

GetFormats()

Sumber:: IDataObject.cs

Sumber:: IDataObject.cs

Sumber:: IDataObject.cs

Sumber:: IDataObject.cs

Sumber:: IDataObject.cs

Mengembalikan daftar semua format yang disimpan data dalam instans ini dikaitkan dengan atau dapat dikonversi.

public:
 cli::array <System::String ^> ^ GetFormats();

public string[] GetFormats();

abstract member GetFormats : unit -> string[]

Public Function GetFormats () As String()

Mengembalikan

String[]

Array nama yang mewakili daftar semua format yang didukung oleh data yang disimpan dalam objek ini.

Contoh

Contoh ini menggunakan DataObject kelas , yang mengimplementasikan IDataObject, untuk menunjukkan penggunaan GetFormats metode . Pertama, ini membuat objek data (myDataObject) menggunakan string dan Text format . Kemudian mengambil semua format data dan format konversi data dalam objek data, dan menampilkan daftar yang dihasilkan dalam kotak pesan. Contoh ini mengasumsikan bahwa Anda telah membuat bernama FormForm1.

private:
   void GetFormats1()
   {
      // Creates a data object using a string and the Text format.
      DataObject^ myDataObject = gcnew DataObject( DataFormats::Text,"My text string" );
      
      // Gets all the data formats and data conversion formats in the data object.
      array<String^>^allFormats = myDataObject->GetFormats();
      
      // Creates the string that contains the formats.
      String^ theResult = "The format(s) associated with the data are: \n";
      for ( int i = 0; i < allFormats->Length; i++ )
         theResult = theResult + allFormats[ i ] + "\n";
      
      // Displays the result in a message box.
      MessageBox::Show( theResult );
   }

private void GetFormats1() 
{
    // Creates a data object using a string and the Text format.
    DataObject myDataObject = new DataObject(DataFormats.Text, "My text string");
 
    // Gets all the data formats and data conversion formats in the data object.
    String[] allFormats = myDataObject.GetFormats();

    // Creates the string that contains the formats.
    string theResult = "The format(s) associated with the data are: " + '\n';
    for(int i = 0; i < allFormats.Length; i++)
        theResult += allFormats[i] + '\n';
    // Displays the result in a message box.
    MessageBox.Show(theResult);
}

Private Sub GetFormats1()
   ' Creates a data object using a string and the Text format.
   Dim myDataObject As New DataObject(DataFormats.Text, "My text string")
   
   ' Gets all the data formats and data conversion formats in the data object.
   Dim allFormats As [String]() = myDataObject.GetFormats()
   
   ' Creates the string that contains the formats.
   Dim theResult As String = "The format(s) associated with the data are: " & _
                vbCr
   Dim i As Integer
   For i = 0 To allFormats.Length - 1
      theResult += allFormats(i) + vbCr
   Next i 
   ' Displays the result in a message box.
   MessageBox.Show(theResult)
End Sub

Keterangan

Panggil metode ini untuk mendapatkan format data yang didukung sebelum memanggil GetData metode . DataFormats Lihat kelas untuk format yang telah ditentukan sebelumnya.

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

Lihat juga

Berlaku untuk

GetFormats(Boolean)

Sumber:: IDataObject.cs

Sumber:: IDataObject.cs

Sumber:: IDataObject.cs

Sumber:: IDataObject.cs

Sumber:: IDataObject.cs

Mendapatkan daftar semua format yang disimpan data dalam instans ini dikaitkan dengan atau dapat dikonversi ke, menggunakan nilai Boolean untuk menentukan apakah akan mengambil semua format yang dapat dikonversi data ke atau hanya format data asli.

public:
 cli::array <System::String ^> ^ GetFormats(bool autoConvert);

public string[] GetFormats(bool autoConvert);

abstract member GetFormats : bool -> string[]

Public Function GetFormats (autoConvert As Boolean) As String()

Parameter

autoConvert: Boolean

true untuk mengambil semua format yang disimpan data dalam instans ini dikaitkan dengan atau dapat dikonversi ke; false untuk mengambil hanya format data asli.

Mengembalikan

String[]

Array nama yang mewakili daftar semua format yang didukung oleh data yang disimpan dalam objek ini.

Contoh

Contoh ini menggunakan DataObject kelas , yang mengimplementasikan IDataObject, untuk menunjukkan penggunaan GetFormats metode . Pertama, ini membuat objek data (myDataObject) menggunakan string dan UnicodeText format . Kemudian membuat dua kueri untuk mendapatkan format yang terkait dengan data. Dalam kueri pertama, ia mengatur autoConvert parameter ke false : dalam hal ini, hanya format asli data yang dikembalikan. Di kueri kedua, ia mengatur autoConvert parameter ke true, sehingga mendapatkan daftar format, termasuk format tempat data dapat dikonversi. Dalam setiap kasus, daftar yang dihasilkan ditampilkan dalam kotak pesan. Contoh ini mengasumsikan bahwa Anda telah membuat bernama FormForm1.

private:
   void GetFormats2()
   {
      // Creates a new data object using a string and the UnicodeText format.
      DataObject^ myDataObject = gcnew DataObject( DataFormats::UnicodeText,"My text string" );
      
      // Gets the original data formats in the data object by setting the automatic
      // conversion parameter to false.
      array<String^>^myFormatsArray = myDataObject->GetFormats( false );
      
      // Stores the results in a string.
      String^ theResult = "The original format associated with the data is:\n";
      for ( int i = 0; i < myFormatsArray->Length; i++ )
         theResult = theResult + myFormatsArray[ i ] + "\n";
      
      // Gets all data formats and data conversion formats for the data object.
      myFormatsArray = myDataObject->GetFormats( true );
      
      // Stores the results in the string.
      theResult = theResult + "\nThe data format(s) and conversion format(s) associated with the data are:\n";
      for ( int i = 0; i < myFormatsArray->Length; i++ )
         theResult = theResult + myFormatsArray[ i ] + "\n";
      
      // Displays the results.
      MessageBox::Show( theResult );
   }

private void GetFormats2() 
{
    // Creates a new data object using a string and the UnicodeText format.
    DataObject myDataObject = new DataObject(DataFormats.UnicodeText, "My text string");

    // Gets the original data formats in the data object by setting the automatic
    // conversion parameter to false.
    String[] myFormatsArray = myDataObject.GetFormats(false);

    // Stores the results in a string.
    string theResult = "The original format associated with the data is:\n";
    for(int i = 0; i < myFormatsArray.Length; i++)
        theResult += myFormatsArray[i] + '\n';

    // Gets all data formats and data conversion formats for the data object.
    myFormatsArray = myDataObject.GetFormats(true);
 
    // Stores the results in the string.
    theResult += "\nThe data format(s) and conversion format(s) associated with " +
        "the data are:\n";
    for(int i = 0; i < myFormatsArray.Length; i++)
        theResult += myFormatsArray[i] + '\n';

    // Displays the results.
    MessageBox.Show(theResult);
}

Private Sub GetFormats2()
   ' Creates a new data object using a string and the UnicodeText format.
   Dim myDataObject As New DataObject(DataFormats.UnicodeText, "My text string")
   
   ' Gets the original data formats in the data object by setting the automatic
   ' conversion parameter to false.
   Dim myFormatsArray As [String]() = myDataObject.GetFormats(False)
   
   ' Stores the results in a string.
   Dim theResult As String = "The original format associated with the data is:" & vbCr
   Dim i As Integer
   For i = 0 To myFormatsArray.Length - 1
      theResult += myFormatsArray(i) + vbCr
   Next i 
   ' Gets all data formats and data conversion formats for the data object.
   myFormatsArray = myDataObject.GetFormats(True)
   
   ' Stores the results in the string.
   theResult += vbCr + "The data format(s) and conversion format(s) associated with " & _
     "the data are:" & vbCr
   For i = 0 To myFormatsArray.Length - 1
      theResult += myFormatsArray(i) + vbCr
   Next i
   ' Displays the results.
   MessageBox.Show(theResult)
End Sub

Keterangan

Panggil metode ini untuk mendapatkan format data yang didukung sebelum memanggil GetData metode . DataFormats Lihat kelas untuk format yang telah ditentukan sebelumnya.

Note

Untuk implementasi metode ini, lihat DataObject.GetFormats.

Lihat juga

Berlaku untuk

Saran dan Komentar

Apakah halaman ini membantu?