Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

Parameter - Classe

Office 2013 et versions ultérieures

Cette documentation est préliminaire et peut changer.

Propriétés de paramètre. Lorsque l'objet est sérialisé en XML, son nom qualifié est x: paramètre.

Espace de noms :  DocumentFormat.OpenXml.Spreadsheet
Assembly :  DocumentFormat.OpenXml (dans DocumentFormat.OpenXml.dll)

public class Parameter : OpenXmlLeafElement

[ISO/IEC 29500-1 1st Edition]

paramètre (propriétés de paramètre)

Cet élément stocke les propriétés de tous les paramètres utilisés avec des connexions de données externes. Paramètres utilisés pour modifier la requête exécutée à l'extérieur et provoquent des données différentes à extraire dans le classeur. Le type de paramètre utilisé – voir ST_parameterType (§18.18.54) – détermine si l'utilisateur est invité à entrer une valeur avant que les données sont actualisées, ou la valeur est extraite à partir d'une cellule du classeur, ou si la même valeur doit être utilisée jusqu'à ce que modifié explicitement dans la connexion de données. Les paramètres sont autorisés pour les requêtes web et ODBC.

EXEMPLE

Connectivité de données peut utiliser un certain nombre de technologies différentes. Voici un exemple de code XML définissant une connexion à une base de données Microsoft Access, avec un paramètre en fonction de la valeur dans la cellule C1 de la première feuille.

<connection id="1" name="Connection" type="1" refreshedVersion="2"  background="1" saveData="1">
  <dbPr connection="DSN=MS Access     Database;DBQ=C:\Desktop\db1.mdb;DefaultDir=C:\Desktop;DriverId=25;FIL=MS     Access;MaxBufferSize=2048;PageTimeout=5;" command="SELECT Table1.Field1,     Table1.Field2_x000d__x000a_FROM `C:\Desktop\db1`.Table1     Table1_x000d__x000a_WHERE (Table1.Field2=?)"/>
  <parameters count="1">
    <parameter name="user specified value" sqlType="4" parameterType="cell"       cell="Sheet1!$C$1"/>
  </parameters>
</connection>

exemple de fin]

Notez que la chaîne de commande dans l'élément dbPr contient un «? » caractères. Ce caractère est utilisé comme un marqueur de paramètre.

[Remarque: connectivité de données peut utiliser un certain nombre de technologies différentes. Vous trouverez un exemple de valeurs potentielles stockée dans cet attribut à: http://msdn.microsoft.com/library/default.asp?url=/ library/en-us/odbc/htm/odbcstatement_parameters.asp fin de la Remarque]

Éléments parents

paramètres (§18.13.7)

Attributs

Description

Boolean (booléen)

Valeur Boolean à utiliser en tant que paramètre de la requête. Utilisé uniquement lorsque parameterType = valeur.

Les valeurs possibles pour cet attribut sont définies par le type de données boolean W3C XML Schema.

cellule (référence de cellule)

Référence de la cellule qui indique la valeur de la cellule à utiliser pour le paramètre de requête. Utilisé uniquement lorsque parameterType = cellule.

EXEMPLE

<Parameter parameterType="cell" cell="Sheet1!$C$1">

Fin de l’exemple]

Les valeurs possibles pour cet attribut sont définies par le type simple ST_Xstring (§22.9.2.19).

Double (Double)

Valeur numérique de type non entier à utiliser comme paramètre de la requête. Utilisé uniquement lorsque parameterType = valeur.

Les valeurs possibles pour cet attribut sont définies par le type de données double W3C XML Schema.

nombre entier (entier)

Nombre entier à utiliser comme paramètre de la requête. Utilisée lorsque parameterType = valeur.

Les valeurs possibles pour cet attribut sont définies par le type de données int W3C XML Schema.

nom (paramètre)

Le nom du paramètre.

Les valeurs possibles pour cet attribut sont définies par le type simple ST_Xstring (§22.9.2.19).

parameterType (Type de paramètre)

Type du paramètre utilisé. Si celui =valeur, puis la valeur de type boolean, double, entier ou chaîne sont utilisés. Dans ce cas, il est probable qu'un seul de {booléen, double, entier ou chaîne} est spécifié.

Les valeurs possibles pour cet attribut sont définies par le type simple ST_ParameterType (§18.18.54).

invite (chaîne d'invite de paramètre)

Chaîne d'invite pour le paramètre. Présenté à l'utilisateur de la feuille de calcul en même temps que l'interface utilisateur d'entrée pour collecter la valeur du paramètre avant d'actualiser les données externes. Utilisé uniquement lorsque parameterType = prompt.

Les valeurs possibles pour cet attribut sont définies par le type simple ST_Xstring (§22.9.2.19).

refreshOnChange (actualisation des modifications)

Indicateur signalant si la requête doit être actualisé automatiquement lorsque le contenu d'une cellule qui fournit le paramètre valeur est modifiée. Si true, puis des données externes est actualisée à l'aide de la nouvelle valeur du paramètre chaque fois il est modifié. Si false, puis les données externes sont actualisées uniquement lorsque demandé par l'utilisateur, ou actualiser certains autres déclencheurs d'événements (par exemple, classeur ouvert).

Les valeurs possibles pour cet attribut sont définies par le type de données boolean W3C XML Schema.

sqlType (Type de données SQL)

Type de données SQL du paramètre. Pris en charge uniquement pour les sources ODBC.

Les valeurs prises en charge incluent :

-22

SQL_UNSIGNED_OFFSET

-20

SQL_SIGNED_OFFSET

-11

SQL_GUID

-10

SQL_WLONGVARCHAR

-9

SQL_WVARCHAR

-8

SQL_WCHAR

-7

SQL_

-6

SQL_TINYINT

-5

SQL_BIGINT

-4

SQL_LONGVARBINARY

-3

SQL_VARBINARY

-2

SQL_BINARY

-1

SQL_LONGVARCHAR

0

SQL_UNKNOWN_TYPE

1

SQL_

2

SQL_NUMERIC

3

SQL_DECIMAL

4

SQL_INTEGER

5

SQL_SMALLINT

6

SQL_FLOAT

7

SQL_

8

SQL_DOUBLE

9

SQL_TYPE_DATE ou SQL_DATE

10

SQL_TYPE_TIME ou SQL_TIME

11

SQL_TYPE_TIMESTAMP ou SQL_TIMESTAMP

12

SQL_VARCHAR

101

SQL_INTERVAL_YEAR

102

SQL_INTERVAL_MONTH

103

SQL_INTERVAL_DAY

104

SQL_INTERVAL_HOUR

105

SQL_INTERVAL_MINUTE

106

SQL_INTERVAL_SECOND

107

SQL_INTERVAL_YEAR_TO_MONTH

108

SQL_INTERVAL_DAY_TO_HOUR

109

SQL_INTERVAL_DAY_TO_MINUTE

110

SQL_INTERVAL_DAY_TO_SECOND

111

SQL_INTERVAL_HOUR_TO_MINUTE

112

SQL_INTERVAL_HOUR_TO_SECOND

113

SQL_INTERVAL_MINUTE_TO_SECOND

Les valeurs possibles pour cet attribut sont définies par le type de données int W3C XML Schema.

chaîne (String)

Valeur de chaîne à utiliser en tant que paramètre de la requête. Utilisé uniquement lorsque parameterType = valeur.

Les valeurs possibles pour cet attribut sont définies par le type simple ST_Xstring (§22.9.2.19).

[Remarque: le W3C XML Schema definition de cet élément modèle de contenu (CT_Parameter) se trouve dans §A.2. fin de la Remarque]

© ISO/IEC29500: 2008.

Tous les membres statique (Partagé dans Visual Basic)s publics de ce type sont thread-safe. Cela n’est pas garanti pour les membres d’instance.
Afficher: