CellValue Classe

Définition

public class CellValue : DocumentFormat.OpenXml.Spreadsheet.XstringType

[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
[DocumentFormat.OpenXml.SchemaAttr(22, "v")]
public class CellValue : DocumentFormat.OpenXml.Spreadsheet.XstringType

[DocumentFormat.OpenXml.SchemaAttr(22, "v")]
public class CellValue : DocumentFormat.OpenXml.Spreadsheet.XstringType

[DocumentFormat.OpenXml.SchemaAttr("x:v")]
public class CellValue : DocumentFormat.OpenXml.Spreadsheet.XstringType

[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
public class CellValue : DocumentFormat.OpenXml.Spreadsheet.XstringType

type CellValue = class
    inherit XstringType

[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
[<DocumentFormat.OpenXml.SchemaAttr(22, "v")>]
type CellValue = class
    inherit XstringType

[<DocumentFormat.OpenXml.SchemaAttr(22, "v")>]
type CellValue = class
    inherit XstringType

[<DocumentFormat.OpenXml.SchemaAttr("x:v")>]
type CellValue = class
    inherit XstringType

[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
type CellValue = class
    inherit XstringType

Public Class CellValue
Inherits XstringType

Héritage

Object

OpenXmlElement

OpenXmlLeafElement

OpenXmlLeafTextElement

XstringType

CellValue

Héritage

Object

OpenXmlElement

OpenXmlLeafElement

OpenXmlLeafTextElement

TypedOpenXmlLeafTextElement

XstringType

CellValue

Attributs

OfficeAvailabilityAttribute SchemaAttrAttribute

Exemples

L’exemple de code suivant crée un fichier de feuille de calcul nommé « CellValue.xlsx » et écrit le texte « Microsoft » dans la cellule A2.

using System;  
using DocumentFormat.OpenXml;  
using DocumentFormat.OpenXml.Packaging;  
using DocumentFormat.OpenXml.Spreadsheet;  

namespace CellTypeEx  
{  
    class Program  
    {  
        static void Main(string[] args)  
        {  
            string fileName = @"C:\Users\Public\Documents\CellValueEx.xlsx";  

            // Create a spreadsheet document by supplying the fileName.  
            SpreadsheetDocument spreadsheetDocument = SpreadsheetDocument.  
                Create(fileName, SpreadsheetDocumentType.Workbook);  

            // Add a WorkbookPart to the document.  
            WorkbookPart workbookpart = spreadsheetDocument.AddWorkbookPart();  
            workbookpart.Workbook = new Workbook();  

            // Add a WorksheetPart to the WorkbookPart.  
            WorksheetPart worksheetPart = workbookpart.AddNewPart<WorksheetPart>();  
            worksheetPart.Worksheet = new Worksheet(new SheetData());  

            // Add Sheets to the Workbook.  
            Sheets sheets = spreadsheetDocument.WorkbookPart.Workbook.AppendChild<Sheets>(new Sheets());  

            // Append a new worksheet and associate it with the workbook.  
            Sheet sheet = new Sheet()  
            {  
                Id = spreadsheetDocument.WorkbookPart.  
                    GetIdOfPart(worksheetPart),  
                SheetId = 1,  
                Name = "mySheet"  
            };  

            sheets.Append(sheet);  
            Worksheet worksheet = new Worksheet();  
            SheetData sheetData = new SheetData();  

            Row row = new Row() { RowIndex = 2U, Spans = new ListValue<StringValue>() };  
            Cell cell = new Cell()  
            {  
                CellReference = "A2",  
                DataType = CellValues.String,  
                CellValue = new CellValue("Microsoft")  
            };  

            row.Append(cell);  
            sheetData.Append(row);  
            worksheet.Append(sheetData);  
            worksheetPart.Worksheet = worksheet;  
            workbookpart.Workbook.Save();  

            // Close the document.  
            spreadsheetDocument.Close();  

            Console.WriteLine("All done.\nPress a key.");  
            Console.ReadKey();  
        }  
    }  
}  

Imports System  
Imports DocumentFormat.OpenXml  
Imports DocumentFormat.OpenXml.Packaging  
Imports DocumentFormat.OpenXml.Spreadsheet  

Module Module1  
    Sub Main(ByVal args As String())  
        Dim fileName As String = "C:\Users\Public\Documents\CellValueEx.xlsx"  

        ' Create a spreadsheet document by supplying the fileName.  
        Dim spreadsheetDocument As SpreadsheetDocument = _  
            spreadsheetDocument.Create(fileName, SpreadsheetDocumentType.Workbook)  

        ' Add a WorkbookPart to the document.  
        Dim workbookpart As WorkbookPart = spreadsheetDocument.AddWorkbookPart()  
        workbookpart.Workbook = New Workbook()  

        ' Add a WorksheetPart to the WorkbookPart.  
        Dim worksheetPart As WorksheetPart = _  
            workbookpart.AddNewPart(Of WorksheetPart)()  
        worksheetPart.Worksheet = New Worksheet(New SheetData())  

        ' Add Sheets to the Workbook.  
        Dim sheets As Sheets = _  
            spreadsheetDocument.WorkbookPart.Workbook.AppendChild(Of Sheets)(New Sheets())  

        ' Append a new worksheet and associate it with the workbook.  
        Dim sheet As New Sheet() With { _  
         .Id = spreadsheetDocument.WorkbookPart.GetIdOfPart(worksheetPart), _  
         .SheetId = 1, _  
         .Name = "mySheet" _  
        }  

        sheets.Append(sheet)  
        Dim worksheet As New Worksheet()  
        Dim sheetData As New SheetData()  

        Dim row As New Row() With { _  
         .RowIndex = 2UI, _  
         .Spans = New ListValue(Of StringValue)() _  
        }  
        Dim cell As New Cell() With { _  
         .CellReference = "A2", _  
         .DataType = CellValues.[String], _  
         .CellValue = New CellValue("Microsoft") _  
        }  

        row.Append(cell)  
        sheetData.Append(row)  
        worksheet.Append(sheetData)  
        worksheetPart.Worksheet = worksheet  
        workbookpart.Workbook.Save()  

        ' Close the document.  
        spreadsheetDocument.Close()  

        Console.WriteLine("All done." & vbLf & "Press a key.")  
        Console.ReadKey()  
    End Sub  
End Module  

Remarques

[ISO/IEC 29500-1 1st Edition]

v (valeur de cellule)

Cet élément exprime la valeur contenue dans une cellule. Si la cellule contient une chaîne, cette valeur est un index du tableau de chaînes partagé, pointant sur la valeur de chaîne réelle. Sinon, la valeur de la cellule est exprimée directement dans cet élément. Les cellules contenant des formules expriment le dernier résultat calculé de la formule dans cet élément.

Pour les applications ne souhaitant pas implémenter la table de chaînes partagée, une « chaîne inline » peut être exprimée dans un <élément is> sous <c> (au lieu d’un <élément v> sous <c>), de la même façon qu’une chaîne serait exprimée dans la table de chaînes partagée. [Remarque : voir <est> pour un exemple. Fin de la remarque]

[Exemple : Dans cet exemple, la cellule B4 contient le nombre « 360 » et C4 la date UTC 22 novembre 1976, 08 :30.

<c r="B4">  
  <v>360</v>  
</c>  
<c r="C4" t="d">  
  <v>1976-11-22T08:30Z</v>  
</c>  

Fin de l’exemple]

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

[Remarque : La définition de schéma XML W3C du modèle de contenu de cet élément (ST_Xstring) se trouve dans §A.6.9. Fin de la remarque]

ISO/IEC29500 : 2008.

Constructeurs

Propriétés

Méthodes

Implémentations d’interfaces explicites

S’applique à