DataObject.GetFormats Metode

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

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

Overload

Nama	Deskripsi
GetFormats()	Mengembalikan daftar semua format yang disimpan data dalam ini DataObject dikaitkan dengan atau dapat dikonversi.
GetFormats(Boolean)	Mengembalikan daftar semua format yang disimpan data dalam ini DataObject dikaitkan dengan atau dapat dikonversi ke, menggunakan parameter konversi otomatis untuk menentukan apakah hanya mengambil format data asli atau semua format yang dapat dikonversi data.

GetFormats()

Sumber:

DataObject.cs

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

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

public virtual string[] GetFormats();

abstract member GetFormats : unit -> string[]
override this.GetFormats : unit -> string[]

Public Overridable Function GetFormats () As String()

Mengembalikan

String[]

Array jenis String, berisi daftar semua format yang didukung oleh data yang disimpan dalam objek ini.

Penerapan

GetFormats()

Contoh

Contoh kode berikut meminta format yang DataObject terkait dengan datanya, dan format tempat data dapat dikonversi. Daftar yang dihasilkan ditampilkan dalam kotak teks. Kode ini mengharuskan yang textBox1 telah dibuat.

private:
   void GetAllFormats()
   {
      // Creates a new data object using a string and the text format.
      DataObject^ myDataObject = gcnew DataObject( DataFormats::Text,"Another string" );
      
      // Gets all the data formats and data conversion formats in the DataObject.
      array<String^>^ arrayOfFormats = myDataObject->GetFormats();
      
      // Prints the results.
      textBox1->Text = "The format(s) associated with the data are: \n";
      for ( int i = 0; i < arrayOfFormats->Length; i++ )
      {
         textBox1->Text = String::Concat( textBox1->Text, arrayOfFormats[ i ], "\n" );
      }
   }

private void GetAllFormats() {
    // Creates a new data object using a string and the text format.
    DataObject myDataObject = new DataObject(DataFormats.Text, "Another string");
 
    // Gets all the data formats and data conversion formats in the DataObject.
    String[] arrayOfFormats = myDataObject.GetFormats();
 
    // Prints the results.
    textBox1.Text = "The format(s) associated with the data are: " + '\n';
    for(int i=0; i<arrayOfFormats.Length; i++)
       textBox1.Text += arrayOfFormats[i] + '\n';
 }

Private Sub GetAllFormats()
    ' Creates a new data object using a string and the text format.
    Dim myDataObject As New DataObject(DataFormats.Text, "Another string")
    
    ' Gets all the data formats and data conversion formats in the DataObject.
    Dim arrayOfFormats As String() = myDataObject.GetFormats()
    
    ' Prints the results.
    textBox1.Text = "The format(s) associated with the data are: " & ControlChars.Cr
    Dim i As Integer
    For i = 0 To arrayOfFormats.Length - 1
        textBox1.Text += arrayOfFormats(i) & ControlChars.Cr
    Next i
End Sub

Keterangan

Panggil metode ini untuk mendapatkan format data yang didukung sebelum memanggil GetData. Lihat DataFormats 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.

Lihat juga

• GetData(String, Boolean)
• SetData(String, Boolean, Object)
• DataFormats
• GetDataPresent(Type)

GetFormats(Boolean)

Sumber:

DataObject.cs

Mengembalikan daftar semua format yang disimpan data dalam ini DataObject dikaitkan dengan atau dapat dikonversi ke, menggunakan parameter konversi otomatis untuk menentukan apakah hanya mengambil format data asli atau semua format yang dapat dikonversi data.

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

public virtual string[] GetFormats(bool autoConvert);

abstract member GetFormats : bool -> string[]
override this.GetFormats : bool -> string[]

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

Parameter

autoConvert

Boolean

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

Mengembalikan

String[]

Array jenis String, berisi daftar semua format yang didukung oleh data yang disimpan dalam objek ini.

Penerapan

GetFormats(Boolean)

Contoh

Contoh kode berikut meminta format yang DataObject terkait dengan datanya. Kueri pertama menentukan autoConvert parameter sebagai false, sehingga hanya format asli data yang dikembalikan. Kueri kedua menentukan autoConvert parameter sebagai true, sehingga daftar format menyertakan format tempat data dapat dikonversi.

Kode ini mengharuskan yang textBox1 telah dibuat.

private:
   void GetAllFormats2()
   {
      // Creates a new data object using a string and the text format.
      DataObject^ myDataObject = gcnew DataObject( DataFormats::Text,"Another string" );
      
      // Gets the original data formats in the DataObject.
      array<String^>^ arrayOfFormats = myDataObject->GetFormats( false );
      
      // Prints the results.
      textBox1->Text = "The format(s) associated with the data are: \n";
      for ( int i = 0; i < arrayOfFormats->Length; i++ )
      {
         textBox1->Text = String::Concat( textBox1->Text, arrayOfFormats[ i ], "\n" );
      }
      
      // Gets the all data formats and data conversion formats for the DataObject.
      arrayOfFormats = myDataObject->GetFormats( true );
      
      // Prints the results.
      textBox1->Text = String::Concat( textBox1->Text , "The data formats and conversion ",
         "format(s) associated with the data are: \n" );
      for ( int i = 0; i < arrayOfFormats->Length; i++ )
      {
         textBox1->Text = String::Concat( textBox1->Text, arrayOfFormats[ i ], "\n" );
      }
   }

private void GetAllFormats2() {
    // Creates a new data object using a string and the text format.
    DataObject myDataObject = new DataObject(DataFormats.Text, "Another string");
 
    // Gets the original data formats in the DataObject.
    String[] arrayOfFormats = myDataObject.GetFormats(false);
 
    // Prints the results.
    textBox1.Text = "The format(s) associated with the data are: " + '\n';
    for(int i=0; i<arrayOfFormats.Length; i++)
       textBox1.Text += arrayOfFormats[i] + '\n';
 
    // Gets the all data formats and data conversion formats for the DataObject.
    arrayOfFormats = myDataObject.GetFormats(true);
 
    // Prints the results.
    textBox1.Text += "The data formats and conversion format(s) associated with " +
       "the data are: " + '\n';
    for(int i=0; i<arrayOfFormats.Length; i++)
       textBox1.Text += arrayOfFormats[i] + '\n';
 }

Private Sub GetAllFormats2()
    ' Creates a new data object using a string and the text format.
    Dim myDataObject As New DataObject(DataFormats.Text, "Another string")
    
    ' Gets the original data formats in the DataObject.
    Dim arrayOfFormats As String() = myDataObject.GetFormats(False)
    
    ' Prints the results.
    textBox1.Text = "The format(s) associated with the data are: " & ControlChars.Cr
    Dim i As Integer
    For i = 0 To arrayOfFormats.Length - 1
        textBox1.Text += arrayOfFormats(i) + ControlChars.Cr
    Next i 
    ' Gets the all data formats and data conversion formats for the DataObject.
    arrayOfFormats = myDataObject.GetFormats(True)
    
    ' Prints the results.
    textBox1.Text += "The data formats and conversion format(s) associated with " & _
        "the data are: " & ControlChars.Cr
        
    For i = 0 To arrayOfFormats.Length - 1
        textBox1.Text += arrayOfFormats(i) + ControlChars.Cr
    Next i
End Sub

Keterangan

Panggil metode ini untuk mendapatkan format data yang didukung sebelum memanggil GetData. Lihat DataFormats 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.

Lihat juga

• GetData(String, Boolean)
• SetData(String, Boolean, Object)
• DataFormats
• GetDataPresent(Type)