FieldDatabase

FieldDatabase class

Implémente le champ DATABASE.

public class FieldDatabase : Field

Constructeurs

Nom La description
FieldDatabase() Default_Constructor

Propriétés

Nom La description
Connection { get; set; } Obtient ou définit une connexion aux données.
DisplayResult { get; } Obtient le texte qui représente le résultat du champ affiché.
End { get; } Obtient le nœud qui représente la fin du champ.
FileName { get; set; } Obtient ou définit le chemin complet et le nom de fichier de la base de données
FirstRecord { get; set; } Obtient ou définit le numéro d’enregistrement intégral du premier enregistrement de données à insérer.
Format { get; } Obtient unFieldFormat objet qui fournit un accès typé au formatage du champ.
FormatAttributes { get; set; } Obtient ou définit les attributs du format à appliquer à la table.
InsertHeadings { get; set; } Obtient ou définit s’il faut insérer les noms de champ de la base de données en tant qu’en-têtes de colonne dans la table résultante.
InsertOnceOnMailMerge { get; set; } Obtient ou définit s’il faut insérer des données au début d’une fusion.
IsDirty { get; set; } Obtient ou définit si le résultat actuel du champ n’est plus correct (périmé) en raison d’autres modifications apportées au document.
IsLocked { get; set; } Obtient ou définit si le champ est verrouillé (ne doit pas recalculer son résultat).
LastRecord { get; set; } Obtient ou définit le numéro d’enregistrement intégral du dernier enregistrement de données à insérer.
LocaleId { get; set; } Obtient ou définit le LCID du champ.
Query { get; set; } Obtient ou définit un ensemble d’instructions SQL qui interrogent la base de données.
Result { get; set; } Obtient ou définit le texte qui se trouve entre le séparateur de champ et la fin du champ.
Separator { get; } Obtient le nœud qui représente le séparateur de champs. Peut être null.
Start { get; } Obtient le nœud qui représente le début du champ.
TableFormat { get; set; } Obtient ou définit le format à appliquer au résultat de la requête de base de données.
virtual Type { get; } Obtient le type de champ Microsoft Word.

Méthodes

Nom La description
GetFieldCode() Renvoie le texte entre le début du champ et le séparateur de champ (ou la fin du champ s’il n’y a pas de séparateur). Le code de champ et le résultat du champ des champs enfants sont inclus.
GetFieldCode(bool) Renvoie le texte entre le début du champ et le séparateur de champ (ou la fin du champ s’il n’y a pas de séparateur).
Remove() Supprime le champ du document. Renvoie un nœud juste après le champ. Si la fin du champ est le dernier enfant de son nœud parent, renvoie son paragraphe parent. Si le champ est déjà supprimé, renvoie nul .
Unlink() Effectue la dissociation du champ.
Update() Effectue la mise à jour du champ. Lance si le champ est déjà mis à jour.
Update(bool) Effectue une mise à jour du champ. Lance si le champ est déjà mis à jour.

Remarques

Insère les résultats d’une requête de base de données dans une table WordprocessingML.

Exemples

Montre comment extraire des données d’une base de données et les insérer en tant que champ dans un document.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Ce champ DATABASE exécutera une requête sur une base de données et affichera le résultat dans une table.
FieldDatabase field = (FieldDatabase)builder.InsertField(FieldType.FieldDatabase, true);
field.FileName = MyDir + @"Database\Northwind.mdb";
field.Connection = "DSN=MS Access Databases";
field.Query = "SELECT * FROM [Products]";

Assert.AreEqual($" DATABASE  \\d \"{DatabaseDir.Replace("\\", "\\\\") + "Northwind.mdb"}\" \\c \"DSN=MS Access Databases\" \\s \"SELECT * FROM [Products]\"", 
    field.GetFieldCode());

// Insérez un autre champ DATABASE avec une requête plus complexe qui trie tous les produits par ordre décroissant de ventes brutes.
field = (FieldDatabase)builder.InsertField(FieldType.FieldDatabase, true);
field.FileName = MyDir + @"Database\Northwind.mdb";
field.Connection = "DSN=MS Access Databases";
field.Query =
    "SELECT [Products].ProductName, FORMAT(SUM([Order Details].UnitPrice * (1 - [Order Details].Discount) * [Order Details].Quantity), 'Currency') AS GrossSales " +
    "FROM([Products] " +
    "LEFT JOIN[Order Details] ON[Products].[ProductID] = [Order Details].[ProductID]) " +
    "GROUP BY[Products].ProductName " +
    "ORDER BY SUM([Order Details].UnitPrice* (1 - [Order Details].Discount) * [Order Details].Quantity) DESC";

// Ces propriétés ont la même fonction que les clauses LIMIT et TOP.
// Configurez-les pour afficher uniquement les lignes 1 à 10 du résultat de la requête dans la table du champ.
field.FirstRecord = "1";
field.LastRecord = "10";

// Cette propriété est l'index du format que nous voulons utiliser pour notre table. La liste des formats de tableau se trouve dans le menu "Table AutoFormat..."
// qui apparaît lorsque nous créons un champ DATABASE dans Microsoft Word. L'indice #10 correspond au format "Coloré 3".
field.TableFormat = "10";

// La propriété FormatAttribute est une représentation sous forme de chaîne d'un entier qui stocke plusieurs indicateurs.
// Nous pouvons appliquer paternellement le format vers lequel pointe la propriété TableFormat en définissant différents drapeaux dans cette propriété.
// Le nombre que nous utilisons est la somme d'une combinaison de valeurs correspondant à différents aspects du style de tableau.
// 63 représente 1 (bordures) + 2 (ombrage) + 4 (police) + 8 (couleur) + 16 (ajustement automatique) + 32 (lignes d'en-tête).
field.FormatAttributes = "63";
field.InsertHeadings = true;
field.InsertOnceOnMailMerge = true;

doc.UpdateFields();
doc.Save(ArtifactsDir + "Field.DATABASE.docx");

Voir également