Class Cell

Class Cell

Namespace: Aspose.Cells
Assembly: Aspose.Cells.dll (25.2.0)

Incapsula l’oggetto che rappresenta una singola cella di un Workbook.

public class Cell

Ereditarietà

objectCell

Membri Eredidati

object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

Esempi

Workbook excel = new Workbook();
Cells cells = excel.Worksheets[0].Cells;

//Metti una stringa in una cella
Cell cell = cells[0, 0];
cell.PutValue("Ciao");

string first = cell.StringValue;

//Metti un intero in una cella
cell = cells["B1"];
cell.PutValue(12);

int second = cell.IntValue;

//Metti un double in una cella
cell = cells[0, 2];
cell.PutValue(-1.234);

double third = cell.DoubleValue;

//Metti una formula in una cella
cell = cells["D1"];
cell.Formula = "=B1 + C1";

//Metti una formula combinata: "sum(average(b1,c1), b1)" nella cella b2
cell = cells["b2"];
cell.Formula = "=sum(average(b1,c1), b1)";

//Imposta lo stile di una cella
Style style = cell.GetStyle();
//Imposta il colore di sfondo
style.BackgroundColor = Color.Yellow;
//Imposta il formato di una cella
style.Font.Name = "Courier New";
style.VerticalAlignment = TextAlignmentType.Top;
cell.SetStyle(style);
Dim excel as Workbook = new Workbook()
Dim cells as Cells = exce.Worksheets(0).Cells

'Metti una stringa in una cella
Dim cell as Cell = cells(0, 0)
cell.PutValue("Ciao")

Dim first as String = cell.StringValue

'Metti un intero in una cella
cell = cells("B1")
cell.PutValue(12)

Dim second as Integer = cell.IntValue

'Metti un double in una cella
cell = cells(0, 2)
cell.PutValue(-1.234)

Dim third as Double = cell.DoubleValue

'Metti una formula in una cella
cell = cells("D1")
cell.Formula = "=B1 + C1"

'Metti una formula combinata: "sum(average(b1,c1), b1)" nella cella b2
cell = cells("b2")
cell.Formula = "=sum(average(b1,c1), b1)"

'Imposta lo stile di una cella
Dim style as Style = cell.GetStyle()

'Imposta il colore di sfondo
style.BackgroundColor = Color.Yellow
'Imposta il font di una cella
style.Font.Name = "Courier New"
style.VerticalAlignment = TextAlignmentType.Top
cell.SetStyle(style)

Proprietà

BoolValue

Ottiene il valore booleano contenuto nella cella.

public bool BoolValue { get; }

Valore della Proprietà

bool

Column

Ottiene il numero di colonna (basato su zero) della cella.

public int Column { get; }

Valore della Proprietà

int

Comment

Ottiene il commento di questa cella.

public Comment Comment { get; }

Valore della Proprietà

Comment

Note

Se non ci sono commenti applicabili alla cella, restituisce null.

ContainsExternalLink

Indica se questa cella contiene un link esterno. Si applica solo quando la cella è una cella di formula.

public bool ContainsExternalLink { get; }

Valore della Proprietà

bool

DateTimeValue

Ottiene il valore DateTime contenuto nella cella.

public DateTime DateTimeValue { get; }

Valore della Proprietà

DateTime

DisplayStringValue

Ottiene il valore della stringa formattata di questa cella in base allo stile di visualizzazione della cella.

public string DisplayStringValue { get; }

Valore della Proprietà

string

DoubleValue

Ottiene il valore double contenuto nella cella.

public double DoubleValue { get; }

Valore della Proprietà

double

EmbeddedImage

Ottiene e imposta l’immagine incorporata nella cella.

public byte[] EmbeddedImage { get; set; }

Valore della Proprietà

byte[]

FloatValue

Ottiene il valore float contenuto nella cella.

public float FloatValue { get; }

Valore della Proprietà

float

Formula

Ottiene o imposta una formula della Aspose.Cells.Cell.

public string Formula { get; set; }

Valore della Proprietà

string

Esempi

Workbook excel = new Workbook();
Cells cells = excel.Worksheets[0].Cells;
cells["B6"].Formula = "=SUM(B2:B5, E1) + sheet1!A1";
Dim excel As Workbook =  New Workbook() 
Dim cells As Cells =  excel.Worksheets(0).Cells 
cells("B6").Formula = "=SUM(B2:B5, E1) + sheet1!A1"

Note

Una stringa di formula inizia sempre con un segno uguale (=). E si prega di utilizzare sempre la virgola (,) come delimitatore dei parametri, ad esempio “=SUM(A1, E1, H2)”.

FormulaLocal

Ottiene la formula formattata in base alla localizzazione della cella.

public string FormulaLocal { get; set; }

Valore della Proprietà

string

HasCustomStyle

Indica se questa cella ha impostazioni di stile personalizzate (diverse da quelle predefinite ereditate dalla riga, colonna o workbook corrispondenti).

public bool HasCustomStyle { get; }

Valore della Proprietà

bool

HtmlString

Ottiene e imposta la stringa html che contiene dati e alcuni formati in questa cella.

public string HtmlString { get; set; }

Valore della Proprietà

string

IntValue

Ottiene il valore intero contenuto nella cella.

public int IntValue { get; }

Valore della Proprietà

int

IsArrayFormula

Indica se la formula della cella è una formula di array.

public bool IsArrayFormula { get; }

Valore della Proprietà

bool

IsArrayHeader

Indica se la formula della cella è una formula di array ed è la prima cella dell’array.

public bool IsArrayHeader { get; }

Valore della Proprietà

bool

IsCheckBoxStyle

Indica se impostare questa cella come una casella di controllo.

public bool IsCheckBoxStyle { get; set; }

Valore della Proprietà

bool

IsDynamicArrayFormula

Indica se la formula della cella è una formula di array dinamico (vero) o una formula di array legacy (falso).

public bool IsDynamicArrayFormula { get; }

Valore della Proprietà

bool

IsErrorValue

Controlla se il valore di questa cella è un errore.

public bool IsErrorValue { get; }

Valore della Proprietà

bool

Note

Si applica anche alla cella di formula per controllare se il risultato calcolato è un errore.

IsFormula

Rappresenta se la cella specificata contiene una formula.

public bool IsFormula { get; }

Valore della Proprietà

bool

IsMerged

Controlla se una cella fa parte di un intervallo unito o meno.

public bool IsMerged { get; }

Valore della Proprietà

bool

IsNumericValue

Indica se il valore di questa cella è numerico (int, double e datetime)

public bool IsNumericValue { get; }

Valore della Proprietà

bool

Note

Si applica anche alla cella di formula per controllare il risultato calcolato.

IsSharedFormula

Indica se la formula della cella è parte di una formula condivisa.

public bool IsSharedFormula { get; }

Valore della Proprietà

bool

IsStyleSet

Indica se lo stile della cella è impostato. Se restituisce falso, significa che questa cella ha un formato di cella predefinito.

public bool IsStyleSet { get; }

Valore della Proprietà

bool

IsTableFormula

Indica se questa cella fa parte di una formula di tabella.

public bool IsTableFormula { get; }

Valore della Proprietà

bool

Name

Ottiene il nome della cella.

public string Name { get; }

Valore della Proprietà

string

Note

Il nome di una cella include la lettera della colonna e il numero della riga. Ad esempio, il nome di una cella nella riga 0 e nella colonna 0 è A1.

NumberCategoryType

Rappresenta il tipo di categoria della formattazione numerica di questa cella.

public NumberCategoryType NumberCategoryType { get; }

Valore della Proprietà

NumberCategoryType

Note

Quando il modello di formattazione della cella è combinato con modelli di formattazione condizionale, il tipo restituito corrisponde alla parte utilizzata per il valore corrente di questa cella. Ad esempio, se il modello di formattazione per questa cella è “#,##0;(#,##0);”-";@", allora quando il valore della cella è numerico e non 0, il tipo restituito è Aspose.Cells.NumberCategoryType.Number; Quando il valore della cella è 0 o non è un valore numerico, il tipo restituito è Aspose.Cells.NumberCategoryType.Text.

R1C1Formula

Ottiene o imposta una formula R1C1 della Aspose.Cells.Cell.

public string R1C1Formula { get; set; }

Valore della Proprietà

string

Row

Ottiene il numero di riga (basato su zero) della cella.

public int Row { get; }

Valore della Proprietà

int

SharedStyleIndex

Ottiene l’indice di stile condiviso della cella nella pool di stili.

public int SharedStyleIndex { get; }

Valore della Proprietà

int

StringValue

Ottiene il valore della stringa contenuto nella cella. Se il tipo di questa cella è stringa, allora restituisce il valore della stringa stesso. Per altri tipi di cella, verrà restituito il valore della stringa formattata (formattata con lo stile specificato di questa cella). Il valore formattato della cella è lo stesso di ciò che puoi ottenere da excel quando copi una cella come testo (come copiare la cella in un editor di testo o esportare in csv).

public string StringValue { get; }

Valore della Proprietà

string

Type

Rappresenta il tipo di valore della cella.

public CellValueType Type { get; }

Valore della Proprietà

CellValueType

Value

Ottiene/imposta il valore contenuto in questa cella.

public object Value { get; set; }

Valore della Proprietà

object

Note

Tipo possibile:

null,

Boolean,

DateTime,

Double,

Integer

String.

Per il valore int, può essere restituito come un oggetto Integer o un oggetto Double. E non c’è garanzia che il valore restituito sarà mantenuto come lo stesso tipo di oggetto sempre.

Worksheet

Ottiene il foglio di lavoro genitore.

public Worksheet Worksheet { get; }

Valore della Proprietà

Worksheet

Metodi

Calculate(CalculationOptions)

Calcola la formula della cella.

public void Calculate(CalculationOptions options)

Parametri

options CalculationOptions

Opzioni per il calcolo

Characters(int, int)

Restituisce un oggetto Characters che rappresenta un intervallo di caratteri all’interno del testo della cella.

public FontSetting Characters(int startIndex, int length)

Parametri

startIndex int

L’indice dell’inizio del carattere.

length int

Il numero di caratteri.

Restituisce

FontSetting

Oggetto Characters.

Esempi

Workbook excel = new Workbook();
Cells cells = excel.Worksheets[0].Cells;
cells["A1"].PutValue("Helloworld");
cells["A1"].Characters(5, 5).Font.IsBold = true;
cells["A1"].Characters(5, 5).Font.Color = Color.Blue;
Dim excel as Workbook = new Workbook()
Dim cells as Cells = exce.Worksheets(0).Cells
cells("A1").PutValue("Helloworld")
cells("A1").Characters(5, 5).Font.IsBold = True
cells("A1").Characters(5, 5).Font.Color = Color.Blue

Note

Questo metodo funziona solo su celle con valore stringa.

Copy(Cell)

Copia i dati da una cella sorgente.

public void Copy(Cell cell)

Parametri

cell Cell

Oggetto Aspose.Cells.Cell sorgente.

Equals(object)

Controlla se questo oggetto si riferisce alla stessa cella di un altro.

public override bool Equals(object obj)

Parametri

obj object

un altro oggetto

Restituisce

bool

vero se i due oggetti si riferiscono alla stessa cella.

Equals(Cell)

Controlla se questo oggetto si riferisce alla stessa cella di un altro oggetto cella.

public bool Equals(Cell cell)

Parametri

cell Cell

un altro oggetto cella

Restituisce

bool

vero se i due oggetti cella si riferiscono alla stessa cella.

GetArrayRange()

Ottiene l’intervallo dell’array se la formula della cella è una formula di array.

public CellArea GetArrayRange()

Restituisce

CellArea

L’intervallo dell’array.

Note

Si applica solo quando la formula della cella è una formula di array.

GetCharacters()

Restituisce tutti gli oggetti Characters che rappresentano un intervallo di caratteri all’interno del testo della cella.

public FontSetting[] GetCharacters()

Restituisce

FontSetting[]

Tutti gli oggetti Characters.

GetCharacters(bool)

Restituisce tutti gli oggetti Characters che rappresentano un intervallo di caratteri all’interno del testo della cella.

public FontSetting[] GetCharacters(bool flag)

Parametri

flag bool

Indica se applicare lo stile della tabella alla cella se la cella è nella tabella.

Restituisce

FontSetting[]

Tutti gli oggetti Characters.

GetConditionalFormattingResult()

Ottiene il risultato della formattazione condizionale.

public ConditionalFormattingResult GetConditionalFormattingResult()

Restituisce

ConditionalFormattingResult

Note

Restituisce null se non è stata applicata alcuna formattazione condizionale a questa cella.

GetDependents(bool)

Ottiene tutte le celle la cui formula fa riferimento direttamente a questa cella.

public Cell[] GetDependents(bool isAll)

Parametri

isAll bool

Indica se controllare le formule in altri fogli di lavoro.

Restituisce

Cell[]

Esempi

Workbook workbook = new Workbook();
Cells cells = workbook.Worksheets[0].Cells;
cells["A1"].Formula = "=B1+SUM(B1:B10)+[Book1.xls]Sheet1!B2";
cells["A2"].Formula = "=IF(TRUE,B2,B1)";
Cell[] dependents = cells["B1"].GetDependents(true);
for (int i = 0; i < dependents.Length; i++)
{
     Console.WriteLine(dependents[i].Name);
}

Note

  • Se un riferimento contenente questa cella appare nella formula di una cella, quella cella sarà considerata il dipendente di questa cella, indipendentemente dal fatto che il riferimento o questa cella sia utilizzata o meno durante il calcolo. Ad esempio, anche se la cella A2 nella formula "=IF(TRUE,A1,A2)" non è utilizzata durante il calcolo, questa formula è comunque considerata come dipendente di A2.
  • Per ottenere quelle formule il cui risultato calcolato dipende da questa cella, si prega di utilizzare Aspose.Cells.Cell.GetDependentsInCalculation(System.Boolean).
  • Quando si tracciano i dipendenti per una cella, tutte le formule nel workbook o nel foglio di lavoro verranno analizzate e controllate. Quindi si tratta di un processo che consuma tempo. Se l'utente deve tracciare i dipendenti per molte celle, utilizzare questo metodo causerà prestazioni scadenti. Per considerazioni sulle prestazioni, l'utente dovrebbe utilizzare Aspose.Cells.Cell.GetDependentsInCalculation(System.Boolean) invece. Oppure, l'utente può raccogliere la mappa dei precedenti di tutte le celle con Aspose.Cells.Cell.GetPrecedents in primo luogo, e quindi costruire la mappa dei dipendenti in base alla mappa dei precedenti.

GetDependentsInCalculation(bool)

Ottiene tutte le celle il cui risultato calcolato dipende da questa cella.

public IEnumerator GetDependentsInCalculation(bool recursive)

Parametri

recursive bool

Se restituisce quei dipendenti che non fanno riferimento a questa cella direttamente ma fanno riferimento ad altre foglie di questa cella.

Restituisce

IEnumerator

Enumerator per enumerare tutti i dipendenti (oggetti Cell).

Esempi

Workbook workbook = new Workbook();
Cells cells = workbook.Worksheets[0].Cells;
cells["A1"].Formula = "=B1+SUM(B1:B10)+[Book1.xls]Sheet1!B2";
cells["A2"].Formula = "=IF(TRUE,B2,B1)";
workbook.Settings.FormulaSettings.EnableCalculationChain = true;
workbook.CalculateFormula();
IEnumerator en = cells["B1"].GetDependentsInCalculation(false);
Console.WriteLine("Dipendenti di calcolo di B1:");
while(en.MoveNext())
{
    Cell c = (Cell)en.Current;
    Console.WriteLine(c.Name);
}
en = cells["B2"].GetDependentsInCalculation(false);
Console.WriteLine("Dipendenti di calcolo di B2:");
while(en.MoveNext())
{
    Cell c = (Cell)en.Current;
    Console.WriteLine(c.Name);
}

Note

Per utilizzare questo metodo, si prega di assicurarsi che il workbook sia stato impostato con un valore vero per Aspose.Cells.FormulaSettings.EnableCalculationChain e che sia stato completamente calcolato con questa impostazione. Se non c’è alcun riferimento di formula a questa cella, verrà restituito null.

GetDisplayStyle()

Ottiene lo stile di visualizzazione della cella. Se questa cella è anche influenzata da altre impostazioni come la formattazione condizionale, oggetti elenco, ecc., allora lo stile di visualizzazione potrebbe essere diverso da cell.GetStyle().

public Style GetDisplayStyle()

Restituisce

Style

GetDisplayStyle(bool)

Ottiene lo stile di visualizzazione della cella. Se la cella è formattata condizionalmente, lo stile di visualizzazione non è lo stesso di cell.GetStyle().

public Style GetDisplayStyle(bool includeMergedBorders)

Parametri

includeMergedBorders bool

Indica se controllare i bordi delle celle unite.

Restituisce

Style

GetFormatConditions()

Ottiene le condizioni di formato che si applicano a questa cella.

public FormatConditionCollection[] GetFormatConditions()

Restituisce

FormatConditionCollection[]

Restituisce l’oggetto Aspose.Cells.FormatConditionCollection.

GetFormula(bool, bool)

Ottiene la formula di questa cella.

public string GetFormula(bool isR1C1, bool isLocal)

Parametri

isR1C1 bool

Se la formula deve essere formattata come R1C1.

isLocal bool

Se la formula deve essere formattata in base alla localizzazione.

Restituisce

string

la formula di questa cella.

GetHashCode()

Funziona come una funzione hash per un tipo particolare.

public override int GetHashCode()

Restituisce

int

Un codice hash per l’oggetto Cell corrente.

GetHeightOfValue()

Ottiene l’altezza del valore in unità di pixel.

public int GetHeightOfValue()

Restituisce

int

GetHtmlString(bool)

Ottiene la stringa html che contiene dati e alcuni formati in questa cella.

public string GetHtmlString(bool html5)

Parametri

html5 bool

Indica se il valore è compatibile con html5.

Restituisce

string

GetMergedRange()

Restituisce un oggetto Aspose.Cells.Range che rappresenta un intervallo unito.

public Range GetMergedRange()

Restituisce

Range

Oggetto Aspose.Cells.Range. Null se questa cella non è unita.

GetPrecedents()

Ottiene tutti i riferimenti che appaiono nella formula di questa cella.

public ReferredAreaCollection GetPrecedents()

Restituisce

ReferredAreaCollection

Collezione di tutti i riferimenti che appaiono nella formula di questa cella.

Esempi

Workbook workbook = new Workbook();
Cells cells = workbook.Worksheets[0].Cells;
cells["A1"].Formula = "=B1+SUM(B1:B10)+[Book1.xls]Sheet1!A1";
ReferredAreaCollection areas = cells["A1"].GetPrecedents();
for (int i = 0; i < areas.Count; i++)
{
     ReferredArea area = areas[i];
     StringBuilder stringBuilder = new StringBuilder();
     if (area.IsExternalLink)
     {
         stringBuilder.Append("[");
         stringBuilder.Append(area.ExternalFileName);
         stringBuilder.Append("]");
     }
     stringBuilder.Append(area.SheetName);
     stringBuilder.Append("!");
     stringBuilder.Append(CellsHelper.CellIndexToName(area.StartRow, area.StartColumn));
     if (area.IsArea)
     {
         stringBuilder.Append(":");
         stringBuilder.Append(CellsHelper.CellIndexToName(area.EndRow, area.EndColumn));
     }
     Console.WriteLine(stringBuilder.ToString());
}
Dim workbook As Workbook = New Workbook()
Dim cells As Cells = workbook.Worksheets(0).Cells
cells("A1").Formula = "= B1 + SUM(B1:B10) + [Book1.xls]Sheet1!A1"
Dim areas As ReferredAreaCollection = cells("A1").GetPrecedents()
For i As Integer = 0 To areas.Count - 1
    Dim area As ReferredArea = areas(i)
    Dim stringBuilder As StringBuilder = New StringBuilder()
    If (area.IsExternalLink) Then
        stringBuilder.Append("[")
        stringBuilder.Append(area.ExternalFileName)
       stringBuilder.Append("]")
    End If
    stringBuilder.Append(area.SheetName)
    stringBuilder.Append("!")
    stringBuilder.Append(CellsHelper.CellIndexToName(area.StartRow, area.StartColumn))
    If (area.IsArea) Then
        stringBuilder.Append(":")
        stringBuilder.Append(CellsHelper.CellIndexToName(area.EndRow, area.EndColumn))
    End If
    Console.WriteLine(stringBuilder.ToString())
Next

Note

  • Restituisce null se questa non è una cella di formula.
  • Tutti i riferimenti che appaiono nella formula di questa cella verranno restituiti indipendentemente dal fatto che siano utilizzati o meno durante il calcolo. Ad esempio, anche se la cella A2 nella formula "=IF(TRUE,A1,A2)" non è utilizzata durante il calcolo, è comunque considerata come precedenti della formula.
  • Per ottenere quei riferimenti che influenzano solo il calcolo, si prega di utilizzare Aspose.Cells.Cell.GetPrecedentsInCalculation.

GetPrecedentsInCalculation()

Ottiene tutti i precedenti (riferimenti a celle nel workbook corrente) utilizzati dalla formula di questa cella durante il calcolo.

public IEnumerator GetPrecedentsInCalculation()

Restituisce

IEnumerator

Enumerator per enumerare tutti i riferimenti (ReferredArea).

Esempi

Workbook workbook = new Workbook();
Cells cells = workbook.Worksheets[0].Cells;
cells["A2"].Formula = "=IF(TRUE,B2,B1)";
workbook.Settings.FormulaSettings.EnableCalculationChain = true;
workbook.CalculateFormula();
IEnumerator en = cells["A2"].GetPrecedentsInCalculation();
Console.WriteLine("Precedenti di calcolo di A2:");
while(en.MoveNext())
{
    ReferredArea r = (ReferredArea)en.Current;
    Console.WriteLine(r);
}

Note

Questo metodo può funzionare solo con la situazione in cui Aspose.Cells.FormulaSettings.EnableCalculationChain è vero per il workbook e il workbook è stato completamente calcolato. Se questa cella non è una formula o non fa riferimento ad altre celle, verrà restituito null.

GetRichValue()

Ottiene il valore ricco della cella.

public CellRichValue GetRichValue()

Restituisce

CellRichValue

GetStringValue(CellValueFormatStrategy)

Ottiene il valore della stringa con una strategia di formattazione specifica.

public string GetStringValue(CellValueFormatStrategy formatStrategy)

Parametri

formatStrategy CellValueFormatStrategy

La strategia di formattazione.

Restituisce

string

GetStyle()

Ottiene lo stile della cella.

public Style GetStyle()

Restituisce

Style

Oggetto stile.

Note

Per modificare lo stile della cella, si prega di chiamare il metodo Cell.SetStyle() dopo aver modificato l’oggetto stile restituito. Questo metodo è lo stesso di Aspose.Cells.Cell.GetStyle(System.Boolean) con valore vero per il parametro.

GetStyle(bool)

Se checkBorders è vero, controlla se i bordi delle altre celle influenzeranno lo stile di questa cella.

public Style GetStyle(bool checkBorders)

Parametri

checkBorders bool

Controlla i bordi delle altre celle.

Restituisce

Style

Oggetto stile.

GetTable()

Ottiene la tabella che contiene questa cella.

public ListObject GetTable()

Restituisce

ListObject

GetValidation()

Ottiene la validazione applicata a questa cella.

public Validation GetValidation()

Restituisce

Validation

GetValidationValue()

Ottiene il valore di validazione applicato a questa cella.

public bool GetValidationValue()

Restituisce

bool

GetWidthOfValue()

Ottiene la larghezza del valore in unità di pixel.

public int GetWidthOfValue()

Restituisce

int

InsertText(int, string)

Inserisce alcuni caratteri nella cella. Se la cella è formattata in modo ricco, questo metodo potrebbe mantenere la formattazione originale.

public void InsertText(int index, string text)

Parametri

index int

L’indice.

text string

Testo inserito.

IsRichText()

Indica se il valore stringa di questa cella è un testo formattato in modo ricco.

public bool IsRichText()

Restituisce

bool

PutValue(bool)

Inserisce un valore booleano nella cella.

public void PutValue(bool boolValue)

Parametri

boolValue bool

PutValue(int)

Inserisce un valore intero nella cella.

public void PutValue(int intValue)

Parametri

intValue int

Valore di input.

PutValue(double)

Inserisce un valore double nella cella.

public void PutValue(double doubleValue)

Parametri

doubleValue double

Valore di input.

PutValue(string, bool, bool)

Inserisce un valore nella cella, se appropriato il valore verrà convertito in un altro tipo di dato e il formato numerico della cella verrà ripristinato.

public void PutValue(string stringValue, bool isConverted, bool setStyle)

Parametri

stringValue string

Valore di input.

isConverted bool

Vero: convertito in un altro tipo di dato se appropriato.

setStyle bool

Vero: imposta il formato numerico allo stile della cella quando si converte in un altro tipo di dato.

PutValue(string, bool)

Inserisce un valore stringa nella cella e converte il valore in un altro tipo di dato se appropriato.

public void PutValue(string stringValue, bool isConverted)

Parametri

stringValue string

Valore di input.

isConverted bool

Vero: convertito in un altro tipo di dato se appropriato.

PutValue(string)

Inserisce un valore stringa nella cella.

public void PutValue(string stringValue)

Parametri

stringValue string

Valore di input.

PutValue(DateTime)

Inserisce un valore DateTime nella cella.

public void PutValue(DateTime dateTime)

Parametri

dateTime DateTime

Valore di input.

Esempi

Questo esempio mostra come impostare un valore DateTime in una cella e farlo visualizzare come data e ora.

Workbook excel = new Workbook();
Cells cells = excel.Worksheets[0].Cells;

//Inserisci data e ora in una cella
Cell cell = cells[0, 0];
cell.PutValue(new DateTime(2023, 5, 15));
Style style = cell.GetStyle(false);
style.Number = 14;
cell.SetStyle(style);

Note

Impostare un valore DateTime per una cella non significa che la cella sarà formattata automaticamente come data e ora. Il valore DateTime è mantenuto come valore numerico nel modello di dati sia di ms excel che di Aspose.Cells. Se il valore numerico sarà considerato come valore numerico stesso o come data e ora dipende dal formato numerico applicato a questa cella. Se questa cella non è stata formattata come data e ora, verrà visualizzata come un valore numerico anche se ciò che hai inserito è DateTime.

PutValue(object)

Inserisce un valore oggetto nella cella.

public void PutValue(object objectValue)

Parametri

objectValue object

valore di input.

RemoveArrayFormula(bool)

Rimuove la formula di array.

public void RemoveArrayFormula(bool leaveNormalFormula)

Parametri

leaveNormalFormula bool

Vero rappresenta la conversione della formula di array in formula normale.

Replace(string, string, ReplaceOptions)

Sostituisce il testo della cella con opzioni.

public void Replace(string placeHolder, string newValue, ReplaceOptions options)

Parametri

placeHolder string

Segnaposto della cella.

newValue string

Valore stringa da sostituire.

options ReplaceOptions

Le opzioni di sostituzione.

SetArrayFormula(string, int, int)

Imposta una formula di array (formula di array legacy inserita tramite CTRL+SHIFT+ENTER in ms excel) su un intervallo di celle.

public void SetArrayFormula(string arrayFormula, int rowNumber, int columnNumber)

Parametri

arrayFormula string

Formula di array.

rowNumber int

Numero di righe per popolare il risultato della formula di array.

columnNumber int

Numero di colonne per popolare il risultato della formula di array.

SetArrayFormula(string, int, int, FormulaParseOptions)

Imposta una formula di array su un intervallo di celle.

public void SetArrayFormula(string arrayFormula, int rowNumber, int columnNumber, FormulaParseOptions options)

Parametri

arrayFormula string

Formula di array.

rowNumber int

Numero di righe per popolare il risultato della formula di array.

columnNumber int

Numero di colonne per popolare il risultato della formula di array.

options FormulaParseOptions

Opzioni per l’analisi della formula.

SetArrayFormula(string, int, int, FormulaParseOptions, object[][])

Imposta una formula di array su un intervallo di celle.

public void SetArrayFormula(string arrayFormula, int rowNumber, int columnNumber, FormulaParseOptions options, object[][] values)

Parametri

arrayFormula string

Formula di array.

rowNumber int

Numero di righe per popolare il risultato della formula di array.

columnNumber int

Numero di colonne per popolare il risultato della formula di array.

options FormulaParseOptions

Opzioni per l’analisi della formula.

values object[][]

valori per quelle celle con la formula di array data.

SetCharacters(FontSetting[])

Imposta il formato di testo ricco della cella.

public void SetCharacters(FontSetting[] characters)

Parametri

characters FontSetting[]

Tutti gli oggetti Characters.

SetDynamicArrayFormula(string, FormulaParseOptions, bool)

Imposta una formula di array dinamico e fa sì che la formula si estenda nelle celle adiacenti se possibile.

public CellArea SetDynamicArrayFormula(string arrayFormula, FormulaParseOptions options, bool calculateValue)

Parametri

arrayFormula string

l’espressione della formula.

options FormulaParseOptions

opzioni per analizzare la formula. L’opzione “Parse” verrà ignorata e la formula verrà sempre analizzata immediatamente.

calculateValue bool

se calcolare questa formula di array dinamico per quelle celle nell’intervallo spillato.

Restituisce

CellArea

l’intervallo in cui la formula dovrebbe spillare.

Note

l’intervallo restituito potrebbe non essere lo stesso di quello reale in cui questa formula di array dinamico spillerebbe. Se ci sono celle non vuote nell’intervallo, la formula verrà impostata solo per la cella corrente e contrassegnata come “#SPILL!”. Ma per tale situazione restituiamo comunque l’intero intervallo in cui questa formula dovrebbe spillare.

SetDynamicArrayFormula(string, FormulaParseOptions, object[][], bool, bool)

Imposta una formula di array dinamico e fa sì che la formula si estenda nelle celle adiacenti se possibile.

public CellArea SetDynamicArrayFormula(string arrayFormula, FormulaParseOptions options, object[][] values, bool calculateRange, bool calculateValue)

Parametri

arrayFormula string

l’espressione della formula.

options FormulaParseOptions

opzioni per analizzare la formula. L’opzione “Parse” verrà ignorata e la formula verrà sempre analizzata immediatamente.

values object[][]

valori (risultati calcolati) per quelle celle con la formula di array dinamico data.

calculateRange bool

Se calcolare l’intervallo spillato per questa formula di array dinamico. Se il parametro “values” non è nullo e questo flag è falso, allora l’altezza dell’intervallo spillato sarà values.Length e la larghezza sarà values[0].Length.

calculateValue bool

se calcolare questa formula di array dinamico per quelle celle nell’intervallo spillato quando “values” è nullo o l’elemento corrispondente in “values” per una cella è nullo.

Restituisce

CellArea

l’intervallo in cui la formula dovrebbe spillare.

Note

l’intervallo restituito potrebbe non essere lo stesso di quello reale in cui questa formula di array dinamico spillerebbe. Se ci sono celle non vuote nell’intervallo, la formula verrà impostata solo per la cella corrente e contrassegnata come “#SPILL!”. Ma per tale situazione restituiamo comunque l’intero intervallo in cui questa formula dovrebbe spillare.

SetDynamicArrayFormula(string, FormulaParseOptions, object[][], bool, bool, CalculationOptions)

Imposta una formula di array dinamico e fa sì che la formula si estenda nelle celle adiacenti se possibile.

public CellArea SetDynamicArrayFormula(string arrayFormula, FormulaParseOptions options, object[][] values, bool calculateRange, bool calculateValue, CalculationOptions copts)

Parametri

arrayFormula string

l’espressione della formula.

options FormulaParseOptions

opzioni per analizzare la formula. L’opzione “Parse” verrà ignorata e la formula verrà sempre analizzata immediatamente.

values object[][]

valori (risultati calcolati) per quelle celle con la formula di array dinamico data.

calculateRange bool

Se calcolare l’intervallo spillato per questa formula di array dinamico. Se il parametro “values” non è nullo e questo flag è falso, allora l’altezza dell’intervallo spillato sarà values.Length e la larghezza sarà values[0].Length.

calculateValue bool

se calcolare questa formula di array dinamico per quelle celle nell’intervallo spillato quando “values” è nullo o l’elemento corrispondente in “values” per una cella è nullo.

copts CalculationOptions

Le opzioni per calcolare la formula. Comunemente, per considerazioni sulle prestazioni, la proprietà Aspose.Cells.CalculationOptions.Recursive dovrebbe essere falsa.

Restituisce

CellArea

l’intervallo in cui la formula dovrebbe spillare.

Note

l’intervallo restituito potrebbe non essere lo stesso di quello reale in cui questa formula di array dinamico spillerebbe. Se ci sono celle non vuote nell’intervallo, la formula verrà impostata solo per la cella corrente e contrassegnata come “#SPILL!”. Ma per tale situazione restituiamo comunque l’intero intervallo in cui questa formula dovrebbe spillare.

SetFormula(string, object)

Imposta la formula e il valore (risultato calcolato) della formula.

public void SetFormula(string formula, object value)

Parametri

formula string

La formula.

value object

Il valore (risultato calcolato) della formula.

SetFormula(string, FormulaParseOptions)

Imposta la formula e il valore (risultato calcolato) della formula.

public void SetFormula(string formula, FormulaParseOptions options)

Parametri

formula string

La formula.

options FormulaParseOptions

Opzioni per analizzare la formula.

SetFormula(string, FormulaParseOptions, object)

Imposta la formula e il valore (risultato calcolato) della formula.

public void SetFormula(string formula, FormulaParseOptions options, object value)

Parametri

formula string

La formula.

options FormulaParseOptions

Opzioni per analizzare la formula.

value object

Il valore (risultato calcolato) della formula.

SetSharedFormula(string, int, int)

Imposta formule condivise su un intervallo di celle.

public void SetSharedFormula(string sharedFormula, int rowNumber, int columnNumber)

Parametri

sharedFormula string

Formula condivisa.

rowNumber int

Numero di righe per popolare la formula.

columnNumber int

Numero di colonne per popolare la formula.

SetSharedFormula(string, int, int, FormulaParseOptions)

Imposta formule condivise su un intervallo di celle.

public void SetSharedFormula(string sharedFormula, int rowNumber, int columnNumber, FormulaParseOptions options)

Parametri

sharedFormula string

Formula condivisa.

rowNumber int

Numero di righe per popolare la formula.

columnNumber int

Numero di colonne per popolare la formula.

options FormulaParseOptions

Opzioni per analizzare la formula.

SetSharedFormula(string, int, int, FormulaParseOptions, object[][])

Imposta formule condivise su un intervallo di celle.

public void SetSharedFormula(string sharedFormula, int rowNumber, int columnNumber, FormulaParseOptions options, object[][] values)

Parametri

sharedFormula string

Formula condivisa.

rowNumber int

Numero di righe per popolare la formula.

columnNumber int

Numero di colonne per popolare la formula.

options FormulaParseOptions

Opzioni per analizzare la formula.

values object[][]

valori per quelle celle con la formula condivisa data.

SetStyle(Style)

Imposta lo stile della cella.

public void SetStyle(Style style)

Parametri

style Style

Lo stile della cella.

Note

Se le impostazioni del bordo vengono modificate, il bordo delle celle di regolazione verrà aggiornato anche.

SetStyle(Style, bool)

Applica la proprietà modificata dello stile alla cella.

public void SetStyle(Style style, bool explicitFlag)

Parametri

style Style

Lo stile della cella.

explicitFlag bool

Vero, sovrascrive solo la formattazione che è stata impostata esplicitamente.

SetStyle(Style, StyleFlag)

Applica lo stile della cella in base ai flag.

public void SetStyle(Style style, StyleFlag flag)

Parametri

style Style

Lo stile della cella.

flag StyleFlag

Il flag di stile.

SetTableFormula(int, int, string, string, object[][])

Crea una tabella dati a due variabili per l’intervallo dato a partire da questa cella.

public void SetTableFormula(int rowNumber, int columnNumber, string rowInputCell, string columnInputCell, object[][] values)

Parametri

rowNumber int

Numero di righe per popolare la formula.

columnNumber int

Numero di colonne per popolare la formula.

rowInputCell string

la cella di input della riga.

columnInputCell string

la cella di input della colonna.

values object[][]

valori per le celle nell’intervallo della formula della tabella.

SetTableFormula(int, int, string, bool, object[][])

Crea una tabella dati a una variabile per l’intervallo dato a partire da questa cella.

public void SetTableFormula(int rowNumber, int columnNumber, string inputCell, bool isRowInput, object[][] values)

Parametri

rowNumber int

Numero di righe per popolare la formula.

columnNumber int

Numero di colonne per popolare la formula.

inputCell string

la cella di input.

isRowInput bool

Indica se la cella di input è una cella di input della riga (vero) o una cella di input della colonna (falso).

values object[][]

valori per le celle nell’intervallo della formula della tabella.

SetTableFormula(int, int, int, int, int, int, object[][])

Crea una tabella dati a due variabili per l’intervallo dato a partire da questa cella.

public void SetTableFormula(int rowNumber, int columnNumber, int rowIndexOfRowInputCell, int columnIndexOfRowInputCell, int rowIndexOfColumnInputCell, int columnIndexOfColumnInputCell, object[][] values)

Parametri

rowNumber int

Numero di righe per popolare la formula.

columnNumber int

Numero di colonne per popolare la formula.

rowIndexOfRowInputCell int

indice di riga della cella di input della riga.

columnIndexOfRowInputCell int

indice di colonna della cella di input della riga.

rowIndexOfColumnInputCell int

indice di riga della cella di input della colonna.

columnIndexOfColumnInputCell int

indice di colonna della cella di input della colonna.

values object[][]

valori per le celle nell’intervallo della formula della tabella.

SetTableFormula(int, int, int, int, bool, object[][])

Crea una tabella dati a una variabile per l’intervallo dato a partire da questa cella.

public void SetTableFormula(int rowNumber, int columnNumber, int rowIndexOfInputCell, int columnIndexOfInputCell, bool isRowInput, object[][] values)

Parametri

rowNumber int

Numero di righe per popolare la formula.

columnNumber int

Numero di colonne per popolare la formula.

rowIndexOfInputCell int

indice di riga della cella di input.

columnIndexOfInputCell int

indice di colonna della cella di input.

isRowInput bool

Indica se la cella di input è una cella di input della riga (vero) o una cella di input della colonna (falso).

values object[][]

valori per le celle nell’intervallo della formula della tabella.

ToJson()

Converte Aspose.Cells.Cell in dati strutturati JSON.

public string ToJson()

Restituisce

string

ToString()

Restituisce una stringa che rappresenta l’oggetto Cell corrente.

public override string ToString()

Restituisce

string

 Italiano