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à
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à
Column
Ottiene il numero di colonna (basato su zero) della cella.
public int Column { get; }
Valore della Proprietà
Comment
Ottiene il commento di questa cella.
public Comment Comment { get; }
Valore della Proprietà
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à
DateTimeValue
Ottiene il valore DateTime contenuto nella cella.
public DateTime DateTimeValue { get; }
Valore della Proprietà
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à
DoubleValue
Ottiene il valore double contenuto nella cella.
public double DoubleValue { get; }
Valore della Proprietà
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à
Formula
Ottiene o imposta una formula della Aspose.Cells.Cell.
public string Formula { get; set; }
Valore della Proprietà
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à
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à
HtmlString
Ottiene e imposta la stringa html che contiene dati e alcuni formati in questa cella.
public string HtmlString { get; set; }
Valore della Proprietà
IntValue
Ottiene il valore intero contenuto nella cella.
public int IntValue { get; }
Valore della Proprietà
IsArrayFormula
Indica se la formula della cella è una formula di array.
public bool IsArrayFormula { get; }
Valore della Proprietà
IsArrayHeader
Indica se la formula della cella è una formula di array ed è la prima cella dell’array.
public bool IsArrayHeader { get; }
Valore della Proprietà
IsCheckBoxStyle
Indica se impostare questa cella come una casella di controllo.
public bool IsCheckBoxStyle { get; set; }
Valore della Proprietà
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à
IsErrorValue
Controlla se il valore di questa cella è un errore.
public bool IsErrorValue { get; }
Valore della Proprietà
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à
IsMerged
Controlla se una cella fa parte di un intervallo unito o meno.
public bool IsMerged { get; }
Valore della Proprietà
IsNumericValue
Indica se il valore di questa cella è numerico (int, double e datetime)
public bool IsNumericValue { get; }
Valore della Proprietà
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à
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à
IsTableFormula
Indica se questa cella fa parte di una formula di tabella.
public bool IsTableFormula { get; }
Valore della Proprietà
Name
Ottiene il nome della cella.
public string Name { get; }
Valore della Proprietà
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à
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à
Row
Ottiene il numero di riga (basato su zero) della cella.
public int Row { get; }
Valore della Proprietà
SharedStyleIndex
Ottiene l’indice di stile condiviso della cella nella pool di stili.
public int SharedStyleIndex { get; }
Valore della Proprietà
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à
Type
Rappresenta il tipo di valore della cella.
public CellValueType Type { get; }
Valore della Proprietà
Value
Ottiene/imposta il valore contenuto in questa cella.
public object Value { get; set; }
Valore della Proprietà
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à
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
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
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
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
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
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
Tutti gli oggetti Characters.
GetConditionalFormattingResult()
Ottiene il risultato della formattazione condizionale.
public ConditionalFormattingResult GetConditionalFormattingResult()
Restituisce
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
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
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
GetFormatConditions()
Ottiene le condizioni di formato che si applicano a questa cella.
public FormatConditionCollection[] GetFormatConditions()
Restituisce
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
la formula di questa cella.
GetHashCode()
Funziona come una funzione hash per un tipo particolare.
public override int GetHashCode()
Restituisce
Un codice hash per l’oggetto Cell corrente.
GetHeightOfValue()
Ottiene l’altezza del valore in unità di pixel.
public int GetHeightOfValue()
Restituisce
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
GetMergedRange()
Restituisce un oggetto Aspose.Cells.Range che rappresenta un intervallo unito.
public Range GetMergedRange()
Restituisce
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
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
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
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
GetStyle()
Ottiene lo stile della cella.
public Style GetStyle()
Restituisce
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
Oggetto stile.
GetTable()
Ottiene la tabella che contiene questa cella.
public ListObject GetTable()
Restituisce
GetValidation()
Ottiene la validazione applicata a questa cella.
public Validation GetValidation()
Restituisce
GetValidationValue()
Ottiene il valore di validazione applicato a questa cella.
public bool GetValidationValue()
Restituisce
GetWidthOfValue()
Ottiene la larghezza del valore in unità di pixel.
public int GetWidthOfValue()
Restituisce
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
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
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
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
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
ToString()
Restituisce una stringa che rappresenta l’oggetto Cell corrente.
public override string ToString()