IDataObject.GetFormats Yöntem

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Bu örnekte depolanan verilerin ilişkili olduğu veya dönüştürülebileceği tüm biçimlerin listesini döndürür.

Aşırı Yüklemeler

GetFormats()	Bu örnekte depolanan verilerin ilişkili olduğu veya dönüştürülebileceği tüm biçimlerin listesini döndürür.
GetFormats(Boolean)	Verilerin dönüştürülebileceği tüm biçimlerin mi yoksa yalnızca yerel veri biçimlerinin mi alındığını belirlemek için boole değeri kullanarak, bu örnekte depolanan verilerin ilişkilendirileceği veya dönüştürülebileceği tüm biçimlerin listesini alır.

GetFormats()

Bu örnekte depolanan verilerin ilişkili olduğu veya dönüştürülebileceği tüm biçimlerin listesini döndürür.

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

public string[] GetFormats ();

abstract member GetFormats : unit -> string[]

Public Function GetFormats () As String()

Döndürülenler

String[]

Bu nesnede depolanan veriler tarafından desteklenen tüm biçimlerin listesini temsil eden ad dizisi.

Örnekler

Bu örnekte yönteminin DataObject kullanımını GetFormats göstermek için uygulayan IDataObjectsınıfı kullanılır. İlk olarak, bir dize ve Text biçim kullanarak bir veri nesnesi (myDataObject) oluşturur. Ardından veri nesnesindeki tüm veri biçimlerini ve veri dönüştürme biçimlerini alır ve sonuçta elde edilen listeyi bir ileti kutusunda görüntüler. Bu örnekte adlı Form1bir Form oluşturduğunuz varsayılır.

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

Açıklamalar

yöntemini çağırmadan önce desteklenen veri biçimlerini almak için bu yöntemi çağırın GetData . DataFormats Önceden tanımlanmış biçimler için sınıfına bakın.

Not

Veriler, dönüştürmeye izin verileceğini belirterek depolanmışsa ve istenen biçim depolanmış biçimle uyumluysa başka bir biçime dönüştürülebilir. Örneğin, Unicode olarak depolanan veriler metne dönüştürülebilir.

Bu yöntemin uygulanması için bkz DataObject.GetFormats. .

Ayrıca bkz.

• GetFormats(Boolean)
• GetData(String, Boolean)

GetFormats(Boolean)

Verilerin dönüştürülebileceği tüm biçimlerin mi yoksa yalnızca yerel veri biçimlerinin mi alındığını belirlemek için boole değeri kullanarak, bu örnekte depolanan verilerin ilişkilendirileceği veya dönüştürülebileceği tüm biçimlerin listesini alır.

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()

Parametreler

autoConvert

Boolean

true bu örnekte depolanan verilerin ilişkili olduğu veya dönüştürülebileceği tüm biçimleri almak için; false yalnızca yerel veri biçimlerini almak için.

Döndürülenler

String[]

Bu nesnede depolanan veriler tarafından desteklenen tüm biçimlerin listesini temsil eden ad dizisi.

Örnekler

Bu örnekte yönteminin DataObject kullanımını GetFormats göstermek için uygulayan IDataObjectsınıfı kullanılır. İlk olarak, bir dize ve UnicodeText biçim kullanarak bir veri nesnesi (myDataObject) oluşturur. Ardından verilerle ilişkili biçimleri almak için iki sorgu yapar. İlk sorguda parametresini autoConvert olarak false ayarlar: bu durumda verilerin yalnızca yerel biçimi döndürülür. İkinci sorguda parametresini autoConvert trueolarak ayarlar, böylece verilerin dönüştürülebileceği biçimler de dahil olmak üzere biçim listesini alır. Her durumda, sonuçta elde edilen liste bir ileti kutusunda görüntülenir. Bu örnekte adlı Form1bir Form oluşturduğunuz varsayılır.

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

Açıklamalar

yöntemini çağırmadan önce desteklenen veri biçimlerini almak için bu yöntemi çağırın GetData . DataFormats Önceden tanımlanmış biçimler için sınıfına bakın.

Not

Veriler, dönüştürmeye izin verileceğini belirterek depolanmışsa ve istenen biçim depolanmış biçimle uyumluysa başka bir biçime dönüştürülebilir. Örneğin, Unicode olarak depolanan veriler metne dönüştürülebilir.

Bu yöntemin uygulanması için bkz DataObject.GetFormats. .

Ayrıca bkz.

• GetFormats(Boolean)
• GetData(String, Boolean)