Méthode RetrieveSystemValues().
Description.
Les méthodes RetrieveSystemValues() et RetrieveSystemValue() interroge l’API QWCRSVAL pour récupérer une ou plusieurs valeurs système d'IBM i.
RetrieveSystemValue(): Récupère une seule valeur système spécifique et la renvoie sous forme d’objetSystemValueInformationcontenant des détails comme le nom, le type de données, et la valeur.RetrieveSystemValues(): Récupère plusieurs valeurs système simultanément et les retourne sous forme de tableauSystemValueInformation, ce qui permet d’obtenir un ensemble de valeurs en un seul appel.
Syntaxe.
// Récupération d'une seule valeur système
RetrieveSystemValue(string value)
// Récupération de plusieurs valeurs système
RetrieveSystemValues(string[] values)Paramètres.
| Nom | Type | Description |
|---|---|---|
value |
string |
Nom de la valeur système à interroger (max 10 caractères). |
validSystemValues |
string[] |
Un tableau contenant les noms des valeurs système à récupérer. Chaque nom ne doit pas dépasser 10 caractères et le tableau peut contenir jusqu’à 158 valeurs système. |
Retour.
RetrieveSystemValue(): Retourne un objet de typeSystemValueInformationcontenant les détails de la valeur système demandée.RetrieveSystemValues(): Retourne un tableau d’objetsSystemValueInformation[]correspondant aux valeurs système demandées.
Classe SystemValueInformation.
| Propriété | Type | Description |
|---|---|---|
| SystemValue | string |
Le nom de la valeur système. |
| DataType | string |
Le type de données de la valeur système, représenté sous forme de chaîne. |
| InformationStatus | string |
Statut de l’information de la valeur système. |
| LengthOfData | int |
Longueur des données de la valeur système, en nombre d’octets. |
| Data | object |
La valeur réelle de la valeur système sous forme d'objet générique. |
Exceptions.
- ArgumentOutOfRangeException : Lancée si le tableau contient plus de 158 noms de valeurs systèmes.
- InvalidOperationException : Lancée si la taille des données retournées est insuffisante pour traiter la requête, ou si une erreur survient lors de l’exécution.
Exemples d’utilisation.
Récupération d’une seule valeur système
var systemValue = conn.RetrieveSystemValue("QTIME");
Console.WriteLine($"System Value: {systemValue.SystemValue}, Data: {systemValue.Data}");Récupération de plusieurs valeurs système.
var systemValues = conn.RetrieveSystemValues(new string[] { "QTIME", "QDATE" });
foreach (var systemValue in systemValues)
{
Console.WriteLine($"System Value: {systemValue.SystemValue}, Data: {systemValue.Data}");
}Références.
Pour plus d’informations sur l’API QWCRSVAL, consultez la documentation officielle IBM.