IDataObject.GetFormats IDataObject.GetFormats IDataObject.GetFormats IDataObject.GetFormats Method

Définition

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.Returns a list of all formats that data stored in this instance is associated with or can be converted to.

Surcharges

GetFormats() GetFormats() GetFormats() 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.Returns a list of all formats that data stored in this instance is associated with or can be converted to.

GetFormats(Boolean) GetFormats(Boolean) GetFormats(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.Gets a list of all formats that data stored in this instance is associated with or can be converted to, using a Boolean value to determine whether to retrieve all formats that the data can be converted to or only native data formats.

GetFormats() GetFormats() GetFormats() 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.Returns a list of all formats that data stored in this instance is associated with or can be converted to.

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.An array of the names that represents a list of all formats that are supported by the data stored in this object.

Exemples

Cet exemple utilise la DataObject classe, qui IDataObjectimplémente, pour illustrer l’utilisation de GetFormats la méthode.This example uses the DataObject class, which implements IDataObject, to demonstrate the use of the GetFormats method. Tout d’abord, elle crée un objetmyDataObjectde données () à l' Text aide d’une chaîne et du format.First, it creates a data object (myDataObject) using a string and the 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 boîte de message.Then it retrieves all the data formats and data conversion formats in the data object, and displays the resulting list in a message box. Cet exemple suppose que vous avez créé un Form nommé. Form1This example assumes that you have created a Form named 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 'GetFormats1

Remarques

Appelez cette méthode pour récupérer les formats de données pris en charge GetData avant d’appeler la méthode.Call this method to get the supported data formats before calling the GetData method. Consultez la DataFormats classe pour les formats prédéfinis.See the DataFormats class for the predefined formats.

Notes

Les données peuvent être converties dans un autre format s’il a été stocké, ce qui spécifie que la conversion est autorisée et si le format demandé est compatible avec le format stocké.Data can be converted to another format if it was stored specifying that conversion is allowed, and if the requested format is compatible with the stored format. Par exemple, les données stockées au format Unicode peuvent être converties en texte.For example, data stored as Unicode can be converted to text.

Pour une implémentation de cette méthode, consultez DataObject.GetFormats.For an implementation of this method, see DataObject.GetFormats.

Voir aussi

GetFormats(Boolean) GetFormats(Boolean) GetFormats(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.Gets a list of all formats that data stored in this instance is associated with or can be converted to, using a Boolean value to determine whether to retrieve all formats that the data can be converted to or only native data formats.

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 Boolean Boolean 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.true to retrieve all formats that data stored in this instance is associated with or can be converted to; false to retrieve only native data formats.

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.An array of the names that represents a list of all formats that are supported by the data stored in this object.

Exemples

Cet exemple utilise la DataObject classe, qui IDataObjectimplémente, pour illustrer l’utilisation de GetFormats la méthode.This example uses the DataObject class, which implements IDataObject, to demonstrate the use of the GetFormats method. Tout d’abord, elle crée un objetmyDataObjectde données () à l' UnicodeText aide d’une chaîne et du format.First, it creates a data object (myDataObject) using a string and the UnicodeText format. Il effectue ensuite deux requêtes pour récupérer les formats associés aux données.Then it makes two queries to get the formats associated with the data. 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é.In the first query, it sets the autoConvert parameter to false : in this case, only the native format of the data is returned. Dans la deuxième requête, elle définit le autoConvert paramètre sur true, afin d’obtenir la liste des formats, y compris les formats dans lesquels les données peuvent être converties.In the second query, it sets the autoConvert parameter to true, so that it gets the list of formats, including the formats that the data can be converted to. Dans chaque cas, la liste résultante s’affiche dans une boîte de message.In each case, the resulting list is displayed in a message box. Cet exemple suppose que vous avez créé un Form nommé. Form1This example assumes that you have created a Form named 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 'GetFormats2

Remarques

Appelez cette méthode pour récupérer les formats de données pris en charge GetData avant d’appeler la méthode.Call this method to get the supported data formats before calling the GetData method. Consultez la DataFormats classe pour les formats prédéfinis.See the DataFormats class for the predefined formats.

Notes

Les données peuvent être converties dans un autre format s’il a été stocké, ce qui spécifie que la conversion est autorisée et si le format demandé est compatible avec le format stocké.Data can be converted to another format if it was stored specifying that conversion is allowed, and if the requested format is compatible with the stored format. Par exemple, les données stockées au format Unicode peuvent être converties en texte.For example, data stored as Unicode can be converted to text.

Pour une implémentation de cette méthode, consultez DataObject.GetFormats.For an implementation of this method, see DataObject.GetFormats.

Voir aussi

S’applique à