IDataObject.GetFormats Méthode

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Retourne la liste de tous les formats auxquels les données stockées dans cette instance sont associées ou dans lesquels ces données peuvent être converties.

Surcharges

GetFormats()	Retourne la liste de tous les formats auxquels les données stockées dans cette instance sont associées ou dans lesquels ces données peuvent être converties.
GetFormats(Boolean)	Obtient la liste de tous les formats auxquels les données stockées dans cette instance sont associées ou dans lesquels ces données peuvent être converties, grâce à une valeur booléenne permettant de déterminer si seuls les formats natifs ou si l'ensemble des formats dans lesquels les données peuvent être converties doivent être récupérés.

GetFormats()

Retourne la liste de tous les formats auxquels les données stockées dans cette instance sont associées ou dans lesquels ces données peuvent être converties.

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

public string[] GetFormats ();

abstract member GetFormats : unit -> string[]

Public Function GetFormats () As String()

Retours

String[]

Tableau de noms représentant la liste de tous les formats pris en charge par les données stockées dans cet objet.

Exemples

Cet exemple utilise la DataObject classe, qui implémente IDataObject, pour illustrer l’utilisation de la GetFormats méthode. Tout d’abord, il crée un objet de données (myDataObject) à l’aide d’une chaîne et du Text format. Ensuite, il récupère tous les formats de données et les formats de conversion de données dans l’objet de données et affiche la liste résultante dans une zone de message. Cet exemple suppose que vous avez créé un Form nom Form1.

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

Remarques

Appelez cette méthode pour obtenir les formats de données pris en charge avant d’appeler la GetData méthode. Consultez la DataFormats classe pour les formats prédéfinis.

Notes

Les données peuvent être converties en un autre format s’il a été stocké en spécifiant que cette conversion est autorisée et si le format demandé est compatible avec le format stocké. Par exemple, les données stockées en unicode peuvent être converties en texte.

Pour obtenir une implémentation de cette méthode, consultez DataObject.GetFormats.

Voir aussi

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

GetFormats(Boolean)

Obtient la liste de tous les formats auxquels les données stockées dans cette instance sont associées ou dans lesquels ces données peuvent être converties, grâce à une valeur booléenne permettant de déterminer si seuls les formats natifs ou si l'ensemble des formats dans lesquels les données peuvent être converties doivent être récupérés.

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

Paramètres

autoConvert

Boolean

true en cas de récupération de tous les formats auxquels les données stockées dans cette instance sont associées ou dans lesquels elles peuvent être converties ; false en cas de récupération des formats de données natifs uniquement.

Retours

String[]

Tableau de noms représentant la liste de tous les formats pris en charge par les données stockées dans cet objet.

Exemples

Cet exemple utilise la DataObject classe, qui implémente IDataObject, pour illustrer l’utilisation de la GetFormats méthode. Tout d’abord, il crée un objet de données (myDataObject) à l’aide d’une chaîne et du UnicodeText format. Ensuite, il effectue deux requêtes pour obtenir les formats associés aux données. Dans la première requête, elle définit le autoConvert paramètre sur false : dans ce cas, seul le format natif des données est retourné. Dans la deuxième requête, il définit le autoConvert paramètre truesur , de sorte qu’il obtient la liste des formats, y compris les formats dans lesquels les données peuvent être converties. Dans chaque cas, la liste résultante s’affiche dans une zone de message. Cet exemple suppose que vous avez créé un Form nom Form1.

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

Remarques

Appelez cette méthode pour obtenir les formats de données pris en charge avant d’appeler la GetData méthode. Consultez la DataFormats classe pour les formats prédéfinis.

Notes

Les données peuvent être converties en un autre format s’il a été stocké en spécifiant que cette conversion est autorisée et si le format demandé est compatible avec le format stocké. Par exemple, les données stockées en unicode peuvent être converties en texte.

Pour obtenir une implémentation de cette méthode, consultez DataObject.GetFormats.

Voir aussi

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