Sheet Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Información de hoja.
Esta clase está disponible en Office 2007 y versiones posteriores.
Cuando el objeto se serializa como xml, su nombre completo es x:sheet.
[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
[DocumentFormat.OpenXml.SchemaAttr(22, "sheet")]
public class Sheet : DocumentFormat.OpenXml.OpenXmlLeafElementpublic class Sheet : DocumentFormat.OpenXml.OpenXmlLeafElement[DocumentFormat.OpenXml.SchemaAttr(22, "sheet")]
public class Sheet : DocumentFormat.OpenXml.OpenXmlLeafElement[DocumentFormat.OpenXml.SchemaAttr("x:sheet")]
public class Sheet : DocumentFormat.OpenXml.OpenXmlLeafElement[DocumentFormat.OpenXml.SchemaAttr("x:sheet")]
public class Sheet : DocumentFormat.OpenXml.TypedOpenXmlLeafElement[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
public class Sheet : DocumentFormat.OpenXml.OpenXmlLeafElement[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
[<DocumentFormat.OpenXml.SchemaAttr(22, "sheet")>]
type Sheet = class
inherit OpenXmlLeafElementtype Sheet = class
inherit OpenXmlLeafElement[<DocumentFormat.OpenXml.SchemaAttr(22, "sheet")>]
type Sheet = class
inherit OpenXmlLeafElement[<DocumentFormat.OpenXml.SchemaAttr("x:sheet")>]
type Sheet = class
inherit OpenXmlLeafElement[<DocumentFormat.OpenXml.SchemaAttr("x:sheet")>]
type Sheet = class
inherit TypedOpenXmlLeafElement[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
type Sheet = class
inherit OpenXmlLeafElementPublic Class Sheet
Inherits OpenXmlLeafElementPublic Class Sheet
Inherits TypedOpenXmlLeafElement- Herencia
- Herencia
- Atributos
Ejemplos
En el ejemplo de código siguiente se inserta una nueva hoja de cálculo en el libro de un documento de hoja de cálculo existente.
using System;
using System.Linq;
using DocumentFormat.OpenXml.Packaging;
using DocumentFormat.OpenXml.Spreadsheet;
namespace SheetEx
{
class Program
{
// Insert a new worksheet in a spreadsheet document.
static void Main(string[] args)
{
string document = @"C:\users\public\documents\SheetsEx.xlsx";
// Open the document for editing.
using (SpreadsheetDocument spreadsheetDocument
= SpreadsheetDocument.Open(document, true))
{
// Add a blank WorksheetPart.
WorksheetPart newWorksheetPart =
spreadsheetDocument.WorkbookPart.AddNewPart<WorksheetPart>();
newWorksheetPart.Worksheet = new Worksheet(new SheetData());
Sheets sheets = spreadsheetDocument.WorkbookPart.Workbook
.GetFirstChild<Sheets>();
string relationshipId = spreadsheetDocument.WorkbookPart
.GetIdOfPart(newWorksheetPart);
// Get a unique ID for the new worksheet.
uint sheetId = 1;
if (sheets.Elements<Sheet>().Count() > 0)
sheetId = sheets.Elements<Sheet>().Select(s => s.SheetId.Value).Max() + 1;
// Give the new worksheet a name.
string sheetName = "mySheet" + sheetId;
// Append the new worksheet and associate it with the workbook.
Sheet sheet = new Sheet() { Id = relationshipId, SheetId = sheetId,
Name = sheetName };
sheets.Append(sheet);
Console.WriteLine("A new sheet has been inserted into the workbook.\nPress a key.");
Console.ReadKey();
}
}
}
}
Imports System.Linq
Imports DocumentFormat.OpenXml.Packaging
Imports DocumentFormat.OpenXml.Spreadsheet
Module Module1
' Insert a new worksheet in a spreadsheet document.
Sub Main(ByVal args As String())
Dim document As String = "C:\users\public\documents\SheetsEx.xlsx"
' Open the document for editing.
Using spreadsheetDocument As SpreadsheetDocument = _
spreadsheetDocument.Open(document, True)
' Add a blank WorksheetPart.
Dim newWorksheetPart As WorksheetPart = _
spreadsheetDocument.WorkbookPart.AddNewPart(Of WorksheetPart)()
newWorksheetPart.Worksheet = New Worksheet(New SheetData())
Dim sheets As Sheets = _
spreadsheetDocument.WorkbookPart.Workbook.GetFirstChild(Of Sheets)()
Dim relationshipId As String = _
spreadsheetDocument.WorkbookPart.GetIdOfPart(newWorksheetPart)
' Get a unique ID for the new worksheet.
Dim sheetId As UInteger = 1
If sheets.Elements(Of Sheet)().Count() > 0 Then
sheetId = sheets.Elements(Of Sheet)().[Select](Function(s) _
s.SheetId.Value).Max() + 1
End If
' Give the new worksheet a name.
Dim sheetName As String = "mySheet" & sheetId
' Append the new worksheet and associate it with the workbook.
Dim sheet As New Sheet() With { _
.Id = relationshipId, _
.SheetId = sheetId, _
.Name = sheetName _
}
sheets.Append(sheet)
Console.WriteLine("A new sheet has been inserted into the workbook." _
& vbLf & "Press a key.")
Console.ReadKey()
End Using
End Sub
End Module
Comentarios
[ISO/IEC 29500-1 1.ª edición]
hoja (información de hoja)
Este elemento define una hoja de este libro. Los datos de la hoja se almacenan en una parte independiente.
| Elementos primarios |
|---|
| sheets (§18.2.20) |
| Atributos | Descripción |
|---|---|
| id (Id. de relación) Espacio de nombres: .../officeDocument/2006/relationships |
Especifica el identificador de la parte de la hoja donde se almacena la definición de esta hoja. Este atributo es obligatorio. Los valores posibles para este atributo se definen mediante el ST_RelationshipId tipo simple (§22.8.2.1). |
| name (Nombre de hoja) | Especifica el nombre de la hoja. Este nombre será único. Este atributo es obligatorio. Los valores posibles para este atributo se definen mediante el ST_Xstring tipo simple (§22.9.2.19). |
| sheetId (id. de pestaña de hoja) | Especifica el identificador interno de la hoja. Este identificador será único. Este atributo es obligatorio. Los valores posibles para este atributo los define el tipo de datos unsignedInt del esquema XML W3C. |
| state (Estado visible) | Especifica el estado visible de esta hoja. El valor predeterminado de este atributo es "visible". Los valores posibles para este atributo se definen mediante el ST_SheetState tipo simple (§18.18.68). |
[Nota: La definición del esquema XML W3C del modelo de contenido de este elemento (CT_Sheet) se encuentra en §A.2. Fin de la nota]
ISO/IEC29500: 2008.
Constructores
| Sheet() |
Inicializa una nueva instancia de la clase Sheet. |
Propiedades
| ChildElements |
Obtiene todos los nodos secundarios del elemento actual. (Heredado de OpenXmlElement) |
| ExtendedAttributes |
Obtiene todos los atributos extendidos (atributos no definidos en el esquema) del elemento actual. (Heredado de OpenXmlElement) |
| Features |
Obtiene un IFeatureCollection para el elemento actual. Esta colección de características será de solo lectura, pero heredará características de su elemento primario y paquete si está disponible. (Heredado de OpenXmlElement) |
| FirstChild |
Obtiene el primer elemento secundario del elemento OpenXmlElement. Devuelve null (Nothing en Visual Basic) si no hay ningún elemento OpenXmlElement de este tipo. (Heredado de OpenXmlElement) |
| HasAttributes |
Obtiene un valor que indica si el elemento actual tiene atributos. (Heredado de OpenXmlElement) |
| HasChildren |
Obtiene un valor que indica si el elemento actual tiene algún elemento secundario. (Heredado de OpenXmlLeafElement) |
| Id |
Identificador de relación Representa el atributo siguiente en el esquema: r:id |
| InnerText |
Obtiene o establece los valores concatenados del nodo y todos sus elementos secundarios. (Heredado de OpenXmlElement) |
| InnerXml |
Obtiene o establece el marcado que solo representa elementos secundarios del elemento actual. (Heredado de OpenXmlLeafElement) |
| LastChild |
Obtiene el último elemento secundario del elemento OpenXmlElement. Devuelve null (Nothing en Visual Basic) si no hay ningún elemento OpenXmlElement de este tipo. (Heredado de OpenXmlElement) |
| LocalName |
Información de hoja. Esta clase está disponible en Office 2007 y versiones posteriores. Cuando el objeto se serializa como xml, su nombre completo es x:sheet. |
| LocalName |
Obtiene el nombre local del elemento actual. (Heredado de OpenXmlElement) |
| MCAttributes |
Obtiene o establece los atributos de compatibilidad de marcado. Devuelve null si no se definen atributos de compatibilidad de marcado para el elemento actual. (Heredado de OpenXmlElement) |
| Name |
Nombre de hoja Representa el atributo siguiente en el esquema: name |
| NamespaceDeclarations |
Obtiene todas las declaraciones de espacio de nombres definidas en el elemento actual. Devuelve un enumerador vacío si no hay ninguna declaración de espacio de nombres. (Heredado de OpenXmlElement) |
| NamespaceUri |
Obtiene el URI del espacio de nombres del elemento actual. (Heredado de OpenXmlElement) |
| OpenXmlElementContext |
Obtiene el Objeto OpenXmlElementContext del elemento actual. (Heredado de OpenXmlElement) |
| OuterXml |
Obtiene el marcado que representa el elemento actual y todos sus elementos secundarios. (Heredado de OpenXmlElement) |
| Parent |
Obtiene el elemento primario del elemento actual. (Heredado de OpenXmlElement) |
| Prefix |
Obtiene el prefijo de espacio de nombres del elemento actual. (Heredado de OpenXmlElement) |
| SheetId |
Id. de pestaña de hoja Representa el atributo siguiente en el esquema: sheetId |
| State |
Estado visible Representa el atributo siguiente en el esquema: estado |
| XmlQualifiedName |
Obtiene el nombre completo del elemento actual. (Heredado de OpenXmlElement) |
| XName |
Obtiene el nombre completo del elemento actual. (Heredado de OpenXmlElement) |
Métodos
| AddAnnotation(Object) |
Agrega un objeto a la lista de anotaciones del elemento OpenXmlElement actual. (Heredado de OpenXmlElement) |
| AddNamespaceDeclaration(String, String) |
Agrega una declaración de espacio de nombres al nodo actual. (Heredado de OpenXmlElement) |
| Ancestors() |
Enumera todos los antecesores del elemento actual. (Heredado de OpenXmlElement) |
| Ancestors<T>() |
Enumera solo los antecesores del elemento actual que tienen el tipo especificado. (Heredado de OpenXmlElement) |
| Annotation(Type) |
Obtenga el primer objeto de anotación del tipo especificado del elemento OpenXmlElement actual. (Heredado de OpenXmlElement) |
| Annotation<T>() |
Obtenga el primer objeto de anotación del tipo especificado del elemento OpenXmlElement actual. (Heredado de OpenXmlElement) |
| Annotations(Type) |
Obtiene una colección de anotaciones con el tipo especificado para el elemento OpenXmlElement actual. (Heredado de OpenXmlElement) |
| Annotations<T>() |
Obtiene una colección de anotaciones con el tipo especificado para el elemento OpenXmlElement actual. (Heredado de OpenXmlElement) |
| Append(IEnumerable<OpenXmlElement>) |
Anexa cada elemento de una lista de elementos al final de la lista de elementos secundarios del elemento actual. (Heredado de OpenXmlElement) |
| Append(OpenXmlElement[]) |
Anexa cada elemento de una matriz de elementos al final de la lista de elementos secundarios del elemento actual. (Heredado de OpenXmlElement) |
| AppendChild<T>(T) |
Anexa el elemento especificado al final de la lista de nodos secundarios del elemento actual. (Heredado de OpenXmlElement) |
| ClearAllAttributes() |
Borra todos los atributos, incluidos los atributos conocidos y los atributos extendidos. (Heredado de OpenXmlElement) |
| Clone() |
Crea un duplicado del nodo actual. (Heredado de OpenXmlElement) |
| CloneNode(Boolean) |
Crea un duplicado de este nodo. |
| Descendants() |
Enumera todos los descendientes del elemento actual. (Heredado de OpenXmlElement) |
| Descendants<T>() |
Enumera todos los descendientes del elemento actual del tipo T. (Heredado de OpenXmlElement) |
| Elements() |
Enumera todos los elementos secundarios del elemento actual. (Heredado de OpenXmlElement) |
| Elements<T>() |
Enumera solo los elementos secundarios del elemento actual que tienen el tipo especificado. (Heredado de OpenXmlElement) |
| ElementsAfter() |
Enumera todos los elementos del mismo nivel que siguen el elemento actual y tienen el mismo elemento primario que el elemento actual. (Heredado de OpenXmlElement) |
| ElementsBefore() |
Enumera todos los elementos del mismo nivel que preceden al elemento actual y tienen el mismo elemento primario que el elemento actual. (Heredado de OpenXmlElement) |
| GetAttribute(String, String) |
Obtiene un atributo Open XML con el nombre de etiqueta y el URI de espacio de nombres especificados. (Heredado de OpenXmlElement) |
| GetAttributes() |
Obtiene una lista que contiene una copia de todos los atributos. (Heredado de OpenXmlElement) |
| GetEnumerator() |
Devuelve un enumerador que recorre en iteración la colección secundaria. (Heredado de OpenXmlElement) |
| GetFirstChild<T>() |
Busca el primer elemento secundario en el tipo T. (Heredado de OpenXmlElement) |
| InsertAfter<T>(T, OpenXmlElement) |
Inserta el elemento especificado inmediatamente después del elemento de referencia especificado. (Heredado de OpenXmlElement) |
| InsertAfterSelf<T>(T) |
Inserta el elemento especificado inmediatamente después del elemento actual. (Heredado de OpenXmlElement) |
| InsertAt<T>(T, Int32) |
Inserta el elemento especificado en el índice especificado en la lista de elementos secundarios del elemento actual. (Heredado de OpenXmlElement) |
| InsertBefore<T>(T, OpenXmlElement) |
Inserta el elemento especificado inmediatamente antes del elemento de referencia especificado. (Heredado de OpenXmlElement) |
| InsertBeforeSelf<T>(T) |
Inserta el elemento especificado inmediatamente antes del elemento actual. (Heredado de OpenXmlElement) |
| IsAfter(OpenXmlElement) |
Determina si el elemento actual aparece después de un elemento especificado en el orden del documento. (Heredado de OpenXmlElement) |
| IsBefore(OpenXmlElement) |
Determina si el elemento actual aparece antes que un elemento especificado en el orden del documento. (Heredado de OpenXmlElement) |
| LookupNamespace(String) |
Resuelve el prefijo de espacio de nombres en el contexto del nodo actual. (Heredado de OpenXmlElement) |
| LookupPrefix(String) |
Busca el prefijo correspondiente para un uri de espacio de nombres en el ámbito del elemento actual. (Heredado de OpenXmlElement) |
| NextSibling() |
Obtiene el elemento OpenXmlElement que sigue inmediatamente al elemento OpenXmlElement actual. Devuelve null (Nothing en Visual Basic) si no hay ningún elemento OpenXmlElement siguiente. (Heredado de OpenXmlElement) |
| NextSibling<T>() |
Obtiene el elemento OpenXmlElement con el tipo especificado que sigue al elemento OpenXmlElement actual. Devuelve null (Nothing en Visual Basic) si no hay ningún elemento OpenXmlElement siguiente. (Heredado de OpenXmlElement) |
| PrependChild<T>(T) |
Inserta el elemento especificado al principio de la lista de elementos secundarios del elemento actual. (Heredado de OpenXmlElement) |
| PreviousSibling() |
Obtiene el elemento OpenXmlElement que precede inmediatamente al elemento OpenXmlElement actual. Devuelve null (Nothing en Visual Basic ) si no hay ningún elemento OpenXmlElement anterior. (Heredado de OpenXmlElement) |
| PreviousSibling<T>() |
Obtiene el elemento OpenXmlElement con el tipo especificado que precede al objeto OpenXmlElement actual. Devuelve null (Nothing en Visual Basic) si no hay ningún elemento OpenXmlElement anterior. (Heredado de OpenXmlElement) |
| Remove() |
Quita el elemento actual de su elemento primario. (Heredado de OpenXmlElement) |
| RemoveAllChildren() |
Quita todos los elementos secundarios del elemento actual. (Heredado de OpenXmlLeafElement) |
| RemoveAllChildren<T>() |
Quite todos los elementos secundarios del elemento actual que son de tipo T. (Heredado de OpenXmlElement) |
| RemoveAnnotations(Type) |
Quita las anotaciones del tipo especificado del elemento OpenXmlElement actual. (Heredado de OpenXmlElement) |
| RemoveAnnotations<T>() |
Quita las anotaciones con el tipo especificado del elemento OpenXmlElement actual. (Heredado de OpenXmlElement) |
| RemoveAttribute(String, String) |
Quita el atributo del elemento actual. (Heredado de OpenXmlElement) |
| RemoveChild<T>(T) |
Quita el elemento secundario especificado de la lista de elementos secundarios del elemento actual. (Heredado de OpenXmlElement) |
| RemoveNamespaceDeclaration(String) |
Quita la declaración de espacio de nombres para el prefijo especificado. No quita nada si no hay ningún prefijo. (Heredado de OpenXmlElement) |
| ReplaceChild<T>(OpenXmlElement, T) |
Reemplaza un elemento secundario por otro elemento secundario en la lista de elementos secundarios del elemento actual. (Heredado de OpenXmlElement) |
| SetAttribute(OpenXmlAttribute) |
Establece un atributo en el elemento especificado. Si el atributo es un atributo conocido, se establece el valor del atributo. Si el atributo es un atributo extendido, el atributo "openxmlAttribute" se agrega a la lista de atributos extendidos. (Heredado de OpenXmlElement) |
| SetAttributes(IEnumerable<OpenXmlAttribute>) |
Establece una serie de atributos en el elemento . Si un atributo es un atributo conocido, se establece el valor del atributo. Si un atributo es un atributo extendido, el atributo "openxmlAttribute" se agrega a la lista de atributos extendidos. (Heredado de OpenXmlElement) |
| WriteTo(XmlWriter) |
Guarda el nodo actual en el objeto XmlWriter especificado. (Heredado de OpenXmlElement) |
Implementaciones de interfaz explícitas
| IEnumerable.GetEnumerator() |
Información de hoja. Esta clase está disponible en Office 2007 y versiones posteriores. Cuando el objeto se serializa como xml, su nombre completo es x:sheet. (Heredado de OpenXmlElement) |
| IEnumerable<OpenXmlElement>.GetEnumerator() |
Devuelve un enumerador que recorre en iteración la colección secundaria. (Heredado de OpenXmlElement) |
Se aplica a
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de