IDataObject.GetFormats Methode

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

public string[] GetFormats();

abstract member GetFormats : unit -> string[]

Public Function GetFormats () As String()

Retouren

Een matrix van de namen die een lijst vertegenwoordigen met alle indelingen die worden ondersteund door de gegevens die in dit object zijn opgeslagen.

Voorbeelden

In dit voorbeeld wordt de DataObject klasse gebruikt, die wordt geïmplementeerd IDataObject, om het gebruik van de GetFormats methode te demonstreren. Eerst wordt er een gegevensobject (myDataObject) gemaakt met behulp van een tekenreeks en de Text indeling. Vervolgens worden alle gegevensindelingen en gegevensconversie-indelingen in het gegevensobject opgehaald en wordt de resulterende lijst weergegeven in een berichtvak. In dit voorbeeld wordt ervan uitgegaan dat u een Form benoemde naam Form1hebt gemaakt.

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

Opmerkingen

Roep deze methode aan om de ondersteunde gegevensindelingen op te halen voordat u de GetData methode aanroept. Bekijk de DataFormats klasse voor de vooraf gedefinieerde indelingen.

Zie voor een implementatie van deze methode DataObject.GetFormats.

Zie ook

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

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

Parameters

Retouren

Een matrix van de namen die een lijst vertegenwoordigen met alle indelingen die worden ondersteund door de gegevens die in dit object zijn opgeslagen.

Voorbeelden

In dit voorbeeld wordt de DataObject klasse gebruikt, die wordt geïmplementeerd IDataObject, om het gebruik van de GetFormats methode te demonstreren. Eerst wordt er een gegevensobject (myDataObject) gemaakt met behulp van een tekenreeks en de UnicodeText indeling. Vervolgens worden er twee query's uitgevoerd om de indelingen op te halen die aan de gegevens zijn gekoppeld. In de eerste query wordt de autoConvert parameter ingesteld op false : in dit geval wordt alleen de systeemeigen indeling van de gegevens geretourneerd. In de tweede query wordt de autoConvert parameter ingesteld op true, zodat de lijst met indelingen wordt opgehaald, inclusief de indelingen waarnaar de gegevens kunnen worden geconverteerd. In elk geval wordt de resulterende lijst weergegeven in een berichtvak. In dit voorbeeld wordt ervan uitgegaan dat u een Form benoemde naam Form1hebt gemaakt.

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

Opmerkingen

Roep deze methode aan om de ondersteunde gegevensindelingen op te halen voordat u de GetData methode aanroept. Bekijk de DataFormats klasse voor de vooraf gedefinieerde indelingen.

Zie voor een implementatie van deze methode DataObject.GetFormats.

Zie ook

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