Class Cell
Namespace: Aspose.Cells
Assembly: Aspose.Cells.dll (25.2.0)
Encapsuluje obiekt, który reprezentuje pojedynczą komórkę w skoroszycie.
public class Cell
Dziedziczenie
Członkowie dziedziczeni
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Przykłady
Workbook excel = new Workbook();
Cells cells = excel.Worksheets[0].Cells;
//Wstawienie ciągu do komórki
Cell cell = cells[0, 0];
cell.PutValue("Hello");
string first = cell.StringValue;
//Wstawienie liczby całkowitej do komórki
cell = cells["B1"];
cell.PutValue(12);
int second = cell.IntValue;
//Wstawienie liczby zmiennoprzecinkowej do komórki
cell = cells[0, 2];
cell.PutValue(-1.234);
double third = cell.DoubleValue;
//Wstawienie formuły do komórki
cell = cells["D1"];
cell.Formula = "=B1 + C1";
//Wstawienie złożonej formuły: "sum(average(b1,c1), b1)" do komórki b2
cell = cells["b2"];
cell.Formula = "=sum(average(b1,c1), b1)";
//Ustawienie stylu komórki
Style style = cell.GetStyle();
//Ustawienie koloru tła
style.BackgroundColor = Color.Yellow;
//Ustawienie formatu komórki
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
'Wstawienie ciągu do komórki
Dim cell as Cell = cells(0, 0)
cell.PutValue("Hello")
Dim first as String = cell.StringValue
'Wstawienie liczby całkowitej do komórki
cell = cells("B1")
cell.PutValue(12)
Dim second as Integer = cell.IntValue
'Wstawienie liczby zmiennoprzecinkowej do komórki
cell = cells(0, 2)
cell.PutValue(-1.234)
Dim third as Double = cell.DoubleValue
'Wstawienie formuły do komórki
cell = cells("D1")
cell.Formula = "=B1 + C1"
'Wstawienie złożonej formuły: "sum(average(b1,c1), b1)" do komórki b2
cell = cells("b2")
cell.Formula = "=sum(average(b1,c1), b1)"
'Ustawienie stylu komórki
Dim style as Style = cell.GetStyle()
'Ustawienie koloru tła
style.BackgroundColor = Color.Yellow
'Ustawienie czcionki komórki
style.Font.Name = "Courier New"
style.VerticalAlignment = TextAlignmentType.Top
cell.SetStyle(style)
Właściwości
BoolValue
Zwraca wartość boolean zawartą w komórce.
public bool BoolValue { get; }
Wartość właściwości
Column
Zwraca numer kolumny (indeks oparty na zerze) komórki.
public int Column { get; }
Wartość właściwości
Comment
Zwraca komentarz tej komórki.
public Comment Comment { get; }
Wartość właściwości
Uwagi
Jeśli nie ma komentarza przypisanego do komórki, zwraca null.
ContainsExternalLink
Wskazuje, czy ta komórka zawiera zewnętrzny link. Dotyczy to tylko, gdy komórka jest komórką formuły.
public bool ContainsExternalLink { get; }
Wartość właściwości
DateTimeValue
Zwraca wartość DateTime zawartą w komórce.
public DateTime DateTimeValue { get; }
Wartość właściwości
DisplayStringValue
Zwraca sformatowaną wartość ciągu tej komórki według stylu wyświetlania komórki.
public string DisplayStringValue { get; }
Wartość właściwości
DoubleValue
Zwraca wartość zmiennoprzecinkową zawartą w komórce.
public double DoubleValue { get; }
Wartość właściwości
EmbeddedImage
Zwraca i ustawia osadzony obraz w komórce.
public byte[] EmbeddedImage { get; set; }
Wartość właściwości
byte[]
FloatValue
Zwraca wartość zmiennoprzecinkową zawartą w komórce.
public float FloatValue { get; }
Wartość właściwości
Formula
Zwraca lub ustawia formułę Aspose.Cells.Cell.
public string Formula { get; set; }
Wartość właściwości
Przykłady
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"
Uwagi
Ciąg formuły zawsze zaczyna się od znaku równości (=). Należy zawsze używać przecinka (,) jako separatora parametrów, na przykład “=SUM(A1, E1, H2)”.
FormulaLocal
Zwraca sformatowaną lokalnie formułę komórki.
public string FormulaLocal { get; set; }
Wartość właściwości
HasCustomStyle
Wskazuje, czy ta komórka ma niestandardowe ustawienia stylu (różne od domyślnych dziedziczonych z odpowiedniego wiersza, kolumny lub skoroszytu).
public bool HasCustomStyle { get; }
Wartość właściwości
HtmlString
Zwraca i ustawia ciąg HTML, który zawiera dane i niektóre formaty w tej komórce.
public string HtmlString { get; set; }
Wartość właściwości
IntValue
Zwraca wartość całkowitą zawartą w komórce.
public int IntValue { get; }
Wartość właściwości
IsArrayFormula
Wskazuje, czy formuła komórki jest formułą tablicową.
public bool IsArrayFormula { get; }
Wartość właściwości
IsArrayHeader
Wskazuje, czy formuła komórki jest formułą tablicową i jest pierwszą komórką tablicy.
public bool IsArrayHeader { get; }
Wartość właściwości
IsCheckBoxStyle
Wskazuje, czy ustawienie tej komórki jako pola wyboru.
public bool IsCheckBoxStyle { get; set; }
Wartość właściwości
IsDynamicArrayFormula
Wskazuje, czy formuła komórki jest dynamiczną formułą tablicową (prawda) czy starą formułą tablicową (fałsz).
public bool IsDynamicArrayFormula { get; }
Wartość właściwości
IsErrorValue
Sprawdza, czy wartość tej komórki jest błędem.
public bool IsErrorValue { get; }
Wartość właściwości
Uwagi
Dotyczy również komórki formuły, aby sprawdzić, czy obliczony wynik jest błędem.
IsFormula
Reprezentuje, czy określona komórka zawiera formułę.
public bool IsFormula { get; }
Wartość właściwości
IsMerged
Sprawdza, czy komórka jest częścią połączonego zakresu.
public bool IsMerged { get; }
Wartość właściwości
IsNumericValue
Wskazuje, czy wartość tej komórki jest numeryczna (int, double i datetime).
public bool IsNumericValue { get; }
Wartość właściwości
Uwagi
Dotyczy również komórki formuły, aby sprawdzić obliczony wynik.
IsSharedFormula
Wskazuje, czy formuła komórki jest częścią wspólnej formuły.
public bool IsSharedFormula { get; }
Wartość właściwości
IsStyleSet
Wskazuje, czy styl komórki jest ustawiony. Jeśli zwraca fałsz, oznacza to, że ta komórka ma domyślny format komórki.
public bool IsStyleSet { get; }
Wartość właściwości
IsTableFormula
Wskazuje, czy ta komórka jest częścią formuły tabeli.
public bool IsTableFormula { get; }
Wartość właściwości
Name
Zwraca nazwę komórki.
public string Name { get; }
Wartość właściwości
Uwagi
Nazwa komórki zawiera literę kolumny i numer wiersza. Na przykład, nazwa komórki w wierszu 0 i kolumnie 0 to A1.
NumberCategoryType
Reprezentuje typ kategorii formatowania liczby tej komórki.
public NumberCategoryType NumberCategoryType { get; }
Wartość właściwości
Uwagi
Gdy wzór formatowania komórki jest połączony z wzorami formatowania warunkowego, zwracany typ odpowiada części, która jest używana do bieżącej wartości tej komórki. Na przykład, jeśli wzór formatowania dla tej komórki to “#,##0;(#,##0);”-";@", wtedy gdy wartość komórki jest numeryczna i nie jest 0, zwracany typ to Aspose.Cells.NumberCategoryType.Number; gdy wartość komórki wynosi 0 lub nie jest wartością numeryczną, zwracany typ to Aspose.Cells.NumberCategoryType.Text.
R1C1Formula
Zwraca lub ustawia formułę R1C1 Aspose.Cells.Cell.
public string R1C1Formula { get; set; }
Wartość właściwości
Row
Zwraca numer wiersza (indeks oparty na zerze) komórki.
public int Row { get; }
Wartość właściwości
SharedStyleIndex
Zwraca indeks współdzielonego stylu komórki w puli stylów.
public int SharedStyleIndex { get; }
Wartość właściwości
StringValue
Zwraca wartość ciągu zawartą w komórce. Jeśli typ tej komórki to ciąg, zwraca samą wartość ciągu. Dla innych typów komórek zwrócona zostanie sformatowana wartość ciągu (sformatowana zgodnie z określonym stylem tej komórki). Sformatowana wartość komórki jest taka sama, jak to, co można uzyskać z excela, kopiując komórkę jako tekst (na przykład kopiując komórkę do edytora tekstu lub eksportując do csv).
public string StringValue { get; }
Wartość właściwości
Type
Reprezentuje typ wartości komórki.
public CellValueType Type { get; }
Wartość właściwości
Value
Zwraca/ustawia wartość zawartą w tej komórce.
public object Value { get; set; }
Wartość właściwości
Uwagi
Możliwe typy:
null,
Boolean,
DateTime,
Double,
Integer
String.
Dla wartości całkowitej może być zwrócona jako obiekt Integer lub obiekt Double. Nie ma gwarancji, że zwrócona wartość zawsze będzie zachowywana jako ten sam typ obiektu.Worksheet
Zwraca macierzystą arkusz roboczy.
public Worksheet Worksheet { get; }
Wartość właściwości
Metody
Calculate(CalculationOptions)
Oblicza formułę komórki.
public void Calculate(CalculationOptions options)
Parametry
options
CalculationOptions
Opcje obliczeń
Characters(int, int)
Zwraca obiekt Characters, który reprezentuje zakres znaków w tekście komórki.
public FontSetting Characters(int startIndex, int length)
Parametry
startIndex
int
Indeks początku znaku.
length
int
Liczba znaków.
Zwraca
Obiekt Characters.
Przykłady
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
Uwagi
Ta metoda działa tylko na komórce z wartością ciągu.
Copy(Cell)
Kopiuje dane z komórki źródłowej.
public void Copy(Cell cell)
Parametry
cell
Cell
Obiekt Aspose.Cells.Cell źródło.
Equals(object)
Sprawdza, czy ten obiekt odnosi się do tej samej komórki co inny.
public override bool Equals(object obj)
Parametry
obj
object
inny obiekt
Zwraca
prawda, jeśli dwa obiekty odnoszą się do tej samej komórki.
Equals(Cell)
Sprawdza, czy ten obiekt odnosi się do tej samej komórki co inny obiekt komórki.
public bool Equals(Cell cell)
Parametry
cell
Cell
inny obiekt komórki
Zwraca
prawda, jeśli dwa obiekty komórki odnoszą się do tej samej komórki.
GetArrayRange()
Zwraca zakres tablicy, jeśli formuła komórki jest formułą tablicową.
public CellArea GetArrayRange()
Zwraca
Zakres tablicy.
Uwagi
Dotyczy tylko, gdy formuła komórki jest formułą tablicową.
GetCharacters()
Zwraca wszystkie obiekty Characters reprezentujące zakres znaków w tekście komórki.
public FontSetting[] GetCharacters()
Zwraca
Wszystkie obiekty Characters.
GetCharacters(bool)
Zwraca wszystkie obiekty Characters reprezentujące zakres znaków w tekście komórki.
public FontSetting[] GetCharacters(bool flag)
Parametry
flag
bool
Wskazuje, czy zastosować styl tabeli do komórki, jeśli komórka znajduje się w tabeli.
Zwraca
Wszystkie obiekty Characters.
GetConditionalFormattingResult()
Zwraca wynik formatowania warunkowego.
public ConditionalFormattingResult GetConditionalFormattingResult()
Zwraca
Uwagi
Zwraca null, jeśli nie zastosowano formatowania warunkowego do tej komórki.
GetDependents(bool)
Zwraca wszystkie komórki, których formuła odnosi się bezpośrednio do tej komórki.
public Cell[] GetDependents(bool isAll)
Parametry
isAll
bool
Wskazuje, czy sprawdzić formuły w innych arkuszach.
Zwraca
Cell[]
Przykłady
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);
}
Uwagi
- Jeśli jeden odniesienie zawierające tę komórkę pojawia się w formule jednej komórki, ta komórka będzie traktowana jako zależna od tej komórki, niezależnie od tego, czy odniesienie lub ta komórka jest używana podczas obliczania. Na przykład, chociaż komórka A2 w formule "=IF(TRUE,A1,A2)" nie jest używana podczas obliczania, ta formuła nadal jest traktowana jako zależna od A2.
- Aby uzyskać te formuły, których obliczone wyniki zależą od tej komórki, należy użyć Aspose.Cells.Cell.GetDependentsInCalculation(System.Boolean).
- Podczas śledzenia zależności dla jednej komórki, wszystkie formuły w skoroszycie lub arkuszu będą analizowane i sprawdzane. Dlatego jest to proces czasochłonny. Jeśli użytkownik potrzebuje śledzić zależności dla wielu komórek, użycie tej metody spowoduje słabą wydajność. Z powodów wydajności użytkownik powinien zamiast tego użyć Aspose.Cells.Cell.GetDependentsInCalculation(System.Boolean). Lub użytkownik może najpierw zebrać mapę precedensów wszystkich komórek za pomocą Aspose.Cells.Cell.GetPrecedents, a następnie zbudować mapę zależności na podstawie mapy precedensów.
GetDependentsInCalculation(bool)
Zwraca wszystkie komórki, których obliczony wynik zależy od tej komórki.
public IEnumerator GetDependentsInCalculation(bool recursive)
Parametry
recursive
bool
Czy zwraca te zależności, które nie odnoszą się bezpośrednio do tej komórki, ale odnoszą się do innych liści tej komórki.
Zwraca
Enumerator do enumerowania wszystkich zależnych (obiektów Cell).
Przykłady
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("Zależności obliczeniowe B1:");
while(en.MoveNext())
{
Cell c = (Cell)en.Current;
Console.WriteLine(c.Name);
}
en = cells["B2"].GetDependentsInCalculation(false);
Console.WriteLine("Zależności obliczeniowe B2:");
while(en.MoveNext())
{
Cell c = (Cell)en.Current;
Console.WriteLine(c.Name);
}
Uwagi
Aby użyć tej metody, upewnij się, że skoroszyt został ustawiony na wartość true dla Aspose.Cells.FormulaSettings.EnableCalculationChain i został w pełni obliczony z tym ustawieniem. Jeśli nie ma odniesienia do tej komórki, zwrócone zostanie null.
GetDisplayStyle()
Zwraca styl wyświetlania komórki. Jeśli ta komórka jest również dotknięta innymi ustawieniami, takimi jak formatowanie warunkowe, obiekty listy itp., wtedy styl wyświetlania może być inny niż cell.GetStyle().
public Style GetDisplayStyle()
Zwraca
GetDisplayStyle(bool)
Zwraca styl wyświetlania komórki. Jeśli komórka jest formatowana warunkowo, styl wyświetlania nie jest taki sam jak cell.GetStyle().
public Style GetDisplayStyle(bool includeMergedBorders)
Parametry
includeMergedBorders
bool
Wskazuje, czy sprawdzić granice połączonych komórek.
Zwraca
GetFormatConditions()
Zwraca warunki formatowania, które mają zastosowanie do tej komórki.
public FormatConditionCollection[] GetFormatConditions()
Zwraca
Zwraca obiekt Aspose.Cells.FormatConditionCollection.
GetFormula(bool, bool)
Zwraca formułę tej komórki.
public string GetFormula(bool isR1C1, bool isLocal)
Parametry
isR1C1
bool
Czy formuła musi być sformatowana jako R1C1.
isLocal
bool
Czy formuła musi być sformatowana według lokalizacji.
Zwraca
formuła tej komórki.
GetHashCode()
Służy jako funkcja haszująca dla danego typu.
public override int GetHashCode()
Zwraca
Kod haszujący dla bieżącego obiektu Cell.
GetHeightOfValue()
Zwraca wysokość wartości w jednostkach pikseli.
public int GetHeightOfValue()
Zwraca
GetHtmlString(bool)
Zwraca ciąg HTML, który zawiera dane i niektóre formaty w tej komórce.
public string GetHtmlString(bool html5)
Parametry
html5
bool
Wskazuje, czy wartość jest zgodna z html5.
Zwraca
GetMergedRange()
Zwraca obiekt Aspose.Cells.Range, który reprezentuje połączony zakres.
public Range GetMergedRange()
Zwraca
Obiekt Aspose.Cells.Range. Null, jeśli ta komórka nie jest połączona.
GetPrecedents()
Zwraca wszystkie odniesienia pojawiające się w formule tej komórki.
public ReferredAreaCollection GetPrecedents()
Zwraca
Kolekcja wszystkich odniesień pojawiających się w formule tej komórki.
Przykłady
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
Uwagi
- Zwraca null, jeśli to nie jest komórka formuły.
- Wszystkie odniesienia pojawiające się w formule tej komórki zostaną zwrócone, niezależnie od tego, czy są one używane podczas obliczania. Na przykład, chociaż komórka A2 w formule "=IF(TRUE,A1,A2)" nie jest używana podczas obliczania, nadal jest traktowana jako precedens formuły.
- Aby uzyskać te odniesienia, które wpływają tylko na obliczenia, należy użyć Aspose.Cells.Cell.GetPrecedentsInCalculation.
GetPrecedentsInCalculation()
Zwraca wszystkie precedensy (odniesienia do komórek w bieżącym skoroszycie) używane przez formułę tej komórki podczas jej obliczania.
public IEnumerator GetPrecedentsInCalculation()
Zwraca
Enumerator do enumerowania wszystkich odniesień (ReferredArea).
Przykłady
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("Precedensy obliczeniowe A2:");
while(en.MoveNext())
{
ReferredArea r = (ReferredArea)en.Current;
Console.WriteLine(r);
}
Uwagi
Ta metoda może działać tylko w sytuacji, gdy Aspose.Cells.FormulaSettings.EnableCalculationChain jest ustawione na true dla skoroszytu i skoroszyt został w pełni obliczony. Jeśli ta komórka nie jest formułą lub nie odnosi się do żadnych innych komórek, zwrócone zostanie null.
GetRichValue()
Zwraca bogatą wartość komórki.
public CellRichValue GetRichValue()
Zwraca
GetStringValue(CellValueFormatStrategy)
Zwraca wartość ciągu według określonej strategii formatowania.
public string GetStringValue(CellValueFormatStrategy formatStrategy)
Parametry
formatStrategy
CellValueFormatStrategy
Strategia formatowania.
Zwraca
GetStyle()
Zwraca styl komórki.
public Style GetStyle()
Zwraca
Obiekt stylu.
Uwagi
Aby zmienić styl komórki, należy wywołać metodę Cell.SetStyle() po modyfikacji zwróconego obiektu stylu. Ta metoda jest taka sama jak Aspose.Cells.Cell.GetStyle(System.Boolean) z wartością true dla parametru.
GetStyle(bool)
Jeśli checkBorders jest prawdziwe, sprawdza, czy granice innych komórek wpłyną na styl tej komórki.
public Style GetStyle(bool checkBorders)
Parametry
checkBorders
bool
Sprawdza granice innych komórek.
Zwraca
Obiekt stylu.
GetTable()
Zwraca tabelę, która zawiera tę komórkę.
public ListObject GetTable()
Zwraca
GetValidation()
Zwraca walidację zastosowaną do tej komórki.
public Validation GetValidation()
Zwraca
GetValidationValue()
Zwraca wartość walidacji, która została zastosowana do tej komórki.
public bool GetValidationValue()
Zwraca
GetWidthOfValue()
Zwraca szerokość wartości w jednostkach pikseli.
public int GetWidthOfValue()
Zwraca
InsertText(int, string)
Wstawia kilka znaków do komórki. Jeśli komórka ma formatowanie bogate, ta metoda może zachować oryginalne formatowanie.
public void InsertText(int index, string text)
Parametry
index
int
Indeks.
text
string
Wstawiony tekst.
IsRichText()
Wskazuje, czy wartość ciągu tej komórki jest tekstem sformatowanym bogato.
public bool IsRichText()
Zwraca
PutValue(bool)
Wstawia wartość boolean do komórki.
public void PutValue(bool boolValue)
Parametry
boolValue
bool
PutValue(int)
Wstawia wartość całkowitą do komórki.
public void PutValue(int intValue)
Parametry
intValue
int
Wartość wejściowa.
PutValue(double)
Wstawia wartość zmiennoprzecinkową do komórki.
public void PutValue(double doubleValue)
Parametry
doubleValue
double
Wartość wejściowa.
PutValue(string, bool, bool)
Wstawia wartość do komórki, jeśli to możliwe, wartość zostanie przekonwertowana na inny typ danych, a format liczby komórki zostanie zresetowany.
public void PutValue(string stringValue, bool isConverted, bool setStyle)
Parametry
stringValue
string
Wartość wejściowa.
isConverted
bool
Prawda: przekonwertowane na inny typ danych, jeśli to możliwe.
setStyle
bool
Prawda: ustawia format liczby na styl komórki podczas konwersji na inny typ danych.
PutValue(string, bool)
Wstawia wartość ciągu do komórki i konwertuje wartość na inny typ danych, jeśli to możliwe.
public void PutValue(string stringValue, bool isConverted)
Parametry
stringValue
string
Wartość wejściowa.
isConverted
bool
Prawda: przekonwertowane na inny typ danych, jeśli to możliwe.
PutValue(string)
Wstawia wartość ciągu do komórki.
public void PutValue(string stringValue)
Parametry
stringValue
string
Wartość wejściowa.
PutValue(DateTime)
Wstawia wartość DateTime do komórki.
public void PutValue(DateTime dateTime)
Parametry
dateTime
DateTime
Wartość wejściowa.
Przykłady
Ten przykład pokazuje, jak ustawić wartość DateTime w komórce i sprawić, aby była wyświetlana jako data i godzina.
Workbook excel = new Workbook();
Cells cells = excel.Worksheets[0].Cells;
//Wstawienie daty i godziny do komórki
Cell cell = cells[0, 0];
cell.PutValue(new DateTime(2023, 5, 15));
Style style = cell.GetStyle(false);
style.Number = 14;
cell.SetStyle(style);
Uwagi
Ustawienie wartości DateTime dla komórki nie oznacza, że komórka będzie automatycznie formatowana jako data i godzina. Wartość DateTime była utrzymywana jako wartość numeryczna w modelu danych zarówno w ms excel, jak i Aspose.Cells. To, czy wartość numeryczna będzie traktowana jako wartość numeryczna sama w sobie, czy jako data i godzina, zależy od formatu liczby zastosowanego do tej komórki. Jeśli ta komórka nie została sformatowana jako data i godzina, zostanie wyświetlona jako wartość numeryczna, nawet jeśli to, co wprowadzasz, to DateTime.
PutValue(object)
Wstawia wartość obiektu do komórki.
public void PutValue(object objectValue)
Parametry
objectValue
object
wartość wejściowa.
RemoveArrayFormula(bool)
Usuwa formułę tablicową.
public void RemoveArrayFormula(bool leaveNormalFormula)
Parametry
leaveNormalFormula
bool
Prawda oznacza konwersję formuły tablicowej na normalną formułę.
Replace(string, string, ReplaceOptions)
Zastępuje tekst komórki z opcjami.
public void Replace(string placeHolder, string newValue, ReplaceOptions options)
Parametry
placeHolder
string
Zastępczy tekst komórki.
newValue
string
Wartość tekstowa do zastąpienia.
options
ReplaceOptions
Opcje zastępowania.
SetArrayFormula(string, int, int)
Ustawia formułę tablicową (stara formuła tablicowa wprowadzona za pomocą CTRL+SHIFT+ENTER w ms excel) do zakresu komórek.
public void SetArrayFormula(string arrayFormula, int rowNumber, int columnNumber)
Parametry
arrayFormula
string
Formuła tablicowa.
rowNumber
int
Liczba wierszy do wypełnienia wynikiem formuły tablicowej.
columnNumber
int
Liczba kolumn do wypełnienia wynikiem formuły tablicowej.
SetArrayFormula(string, int, int, FormulaParseOptions)
Ustawia formułę tablicową do zakresu komórek.
public void SetArrayFormula(string arrayFormula, int rowNumber, int columnNumber, FormulaParseOptions options)
Parametry
arrayFormula
string
Formuła tablicowa.
rowNumber
int
Liczba wierszy do wypełnienia wynikiem formuły tablicowej.
columnNumber
int
Liczba kolumn do wypełnienia wynikiem formuły tablicowej.
options
FormulaParseOptions
Opcje do analizowania formuły.
SetArrayFormula(string, int, int, FormulaParseOptions, object[][])
Ustawia formułę tablicową do zakresu komórek.
public void SetArrayFormula(string arrayFormula, int rowNumber, int columnNumber, FormulaParseOptions options, object[][] values)
Parametry
arrayFormula
string
Formuła tablicowa.
rowNumber
int
Liczba wierszy do wypełnienia wynikiem formuły tablicowej.
columnNumber
int
Liczba kolumn do wypełnienia wynikiem formuły tablicowej.
options
FormulaParseOptions
Opcje do analizowania formuły.
values
object[][]
wartości dla tych komórek z podaną formułą tablicową.
SetCharacters(FontSetting[])
Ustawia formatowanie tekstu bogatego komórki.
public void SetCharacters(FontSetting[] characters)
Parametry
characters
FontSetting[]
Wszystkie obiekty Characters.
SetDynamicArrayFormula(string, FormulaParseOptions, bool)
Ustawia dynamiczną formułę tablicową i sprawia, że formuła rozlewa się do sąsiednich komórek, jeśli to możliwe.
public CellArea SetDynamicArrayFormula(string arrayFormula, FormulaParseOptions options, bool calculateValue)
Parametry
arrayFormula
string
wyrażenie formuły.
options
FormulaParseOptions
opcje do analizowania formuły. Opcja “Parse” zostanie zignorowana, a formuła zawsze zostanie natychmiast przeanalizowana.
calculateValue
bool
czy obliczyć tę dynamiczną formułę tablicową dla tych komórek w rozlanym zakresie.
Zwraca
zakres, do którego formuła powinna się rozlać.
Uwagi
Zwracany zakres może nie być taki sam jak rzeczywisty, do którego ta dynamiczna formuła tablicowa się rozlewa. Jeśli w zakresie znajdują się niepuste komórki, formuła zostanie ustawiona tylko dla bieżącej komórki i oznaczona jako “#SPILL!”. Jednak w takiej sytuacji nadal zwracamy cały zakres, do którego ta formuła powinna się rozlać.
SetDynamicArrayFormula(string, FormulaParseOptions, object[][], bool, bool)
Ustawia dynamiczną formułę tablicową i sprawia, że formuła rozlewa się do sąsiednich komórek, jeśli to możliwe.
public CellArea SetDynamicArrayFormula(string arrayFormula, FormulaParseOptions options, object[][] values, bool calculateRange, bool calculateValue)
Parametry
arrayFormula
string
wyrażenie formuły.
options
FormulaParseOptions
opcje do analizowania formuły. Opcja “Parse” zostanie zignorowana, a formuła zawsze zostanie natychmiast przeanalizowana.
values
object[][]
wartości (wyniki obliczeń) dla tych komórek z podaną dynamiczną formułą tablicową.
calculateRange
bool
Czy obliczyć rozlany zakres dla tej dynamicznej formuły tablicowej. Jeśli parametr “values” nie jest null, a ten znacznik jest fałszywy, to wysokość rozlanego zakresu będzie wartości.Length, a szerokość będzie wartości[0].Length.
calculateValue
bool
czy obliczyć tę dynamiczną formułę tablicową dla tych komórek w rozlanym zakresie, gdy “values” jest null lub odpowiadający element w “values” dla jednej komórki jest null.
Zwraca
zakres, do którego formuła powinna się rozlać.
Uwagi
Zwracany zakres może nie być taki sam jak rzeczywisty, do którego ta dynamiczna formuła tablicowa się rozlewa. Jeśli w zakresie znajdują się niepuste komórki, formuła zostanie ustawiona tylko dla bieżącej komórki i oznaczona jako “#SPILL!”. Jednak w takiej sytuacji nadal zwracamy cały zakres, do którego ta formuła powinna się rozlać.
SetDynamicArrayFormula(string, FormulaParseOptions, object[][], bool, bool, CalculationOptions)
Ustawia dynamiczną formułę tablicową i sprawia, że formuła rozlewa się do sąsiednich komórek, jeśli to możliwe.
public CellArea SetDynamicArrayFormula(string arrayFormula, FormulaParseOptions options, object[][] values, bool calculateRange, bool calculateValue, CalculationOptions copts)
Parametry
arrayFormula
string
wyrażenie formuły.
options
FormulaParseOptions
opcje do analizowania formuły. Opcja “Parse” zostanie zignorowana, a formuła zawsze zostanie natychmiast przeanalizowana.
values
object[][]
wartości (wyniki obliczeń) dla tych komórek z podaną dynamiczną formułą tablicową.
calculateRange
bool
Czy obliczyć rozlany zakres dla tej dynamicznej formuły tablicowej. Jeśli parametr “values” nie jest null, a ten znacznik jest fałszywy, to wysokość rozlanego zakresu będzie wartości.Length, a szerokość będzie wartości[0].Length.
calculateValue
bool
czy obliczyć tę dynamiczną formułę tablicową dla tych komórek w rozlanym zakresie, gdy “values” jest null lub odpowiadający element w “values” dla jednej komórki jest null.
copts
CalculationOptions
Opcje do obliczania formuły. Zazwyczaj, dla względów wydajności, właściwość Aspose.Cells.CalculationOptions.Recursive powinna być fałszywa.
Zwraca
zakres, do którego formuła powinna się rozlać.
Uwagi
Zwracany zakres może nie być taki sam jak rzeczywisty, do którego ta dynamiczna formuła tablicowa się rozlewa. Jeśli w zakresie znajdują się niepuste komórki, formuła zostanie ustawiona tylko dla bieżącej komórki i oznaczona jako “#SPILL!”. Jednak w takiej sytuacji nadal zwracamy cały zakres, do którego ta formuła powinna się rozlać.
SetFormula(string, object)
Ustawia formułę i wartość (wynik obliczeń) formuły.
public void SetFormula(string formula, object value)
Parametry
formula
string
Formuła.
value
object
Wartość (wynik obliczeń) formuły.
SetFormula(string, FormulaParseOptions)
Ustawia formułę i wartość (wynik obliczeń) formuły.
public void SetFormula(string formula, FormulaParseOptions options)
Parametry
formula
string
Formuła.
options
FormulaParseOptions
Opcje do analizowania formuły.
SetFormula(string, FormulaParseOptions, object)
Ustawia formułę i wartość (wynik obliczeń) formuły.
public void SetFormula(string formula, FormulaParseOptions options, object value)
Parametry
formula
string
Formuła.
options
FormulaParseOptions
Opcje do analizowania formuły.
value
object
Wartość (wynik obliczeń) formuły.
SetSharedFormula(string, int, int)
Ustawia współdzielone formuły do zakresu komórek.
public void SetSharedFormula(string sharedFormula, int rowNumber, int columnNumber)
Parametry
sharedFormula
string
Wspólna formuła.
rowNumber
int
Liczba wierszy do wypełnienia formułą.
columnNumber
int
Liczba kolumn do wypełnienia formułą.
SetSharedFormula(string, int, int, FormulaParseOptions)
Ustawia współdzielone formuły do zakresu komórek.
public void SetSharedFormula(string sharedFormula, int rowNumber, int columnNumber, FormulaParseOptions options)
Parametry
sharedFormula
string
Wspólna formuła.
rowNumber
int
Liczba wierszy do wypełnienia formułą.
columnNumber
int
Liczba kolumn do wypełnienia formułą.
options
FormulaParseOptions
Opcje do analizowania formuły.
SetSharedFormula(string, int, int, FormulaParseOptions, object[][])
Ustawia współdzielone formuły do zakresu komórek.
public void SetSharedFormula(string sharedFormula, int rowNumber, int columnNumber, FormulaParseOptions options, object[][] values)
Parametry
sharedFormula
string
Wspólna formuła.
rowNumber
int
Liczba wierszy do wypełnienia formułą.
columnNumber
int
Liczba kolumn do wypełnienia formułą.
options
FormulaParseOptions
Opcje do analizowania formuły.
values
object[][]
wartości dla tych komórek z podaną współdzieloną formułą.
SetStyle(Style)
Ustawia styl komórki.
public void SetStyle(Style style)
Parametry
style
Style
Styl komórki.
Uwagi
Jeśli ustawienia granic zostaną zmienione, granice dostosowanych komórek również zostaną zaktualizowane.
SetStyle(Style, bool)
Zastosuj zmienioną właściwość stylu do komórki.
public void SetStyle(Style style, bool explicitFlag)
Parametry
style
Style
Styl komórki.
explicitFlag
bool
Prawda, tylko nadpisując formatowanie, które jest ustawione explicite.
SetStyle(Style, StyleFlag)
Zastosuj styl komórki na podstawie flag.
public void SetStyle(Style style, StyleFlag flag)
Parametry
style
Style
Styl komórki.
flag
StyleFlag
Flaga stylu.
SetTableFormula(int, int, string, string, object[][])
Tworzy tabelę danych z dwoma zmiennymi dla podanego zakresu zaczynając od tej komórki.
public void SetTableFormula(int rowNumber, int columnNumber, string rowInputCell, string columnInputCell, object[][] values)
Parametry
rowNumber
int
Liczba wierszy do wypełnienia formułą.
columnNumber
int
Liczba kolumn do wypełnienia formułą.
rowInputCell
string
komórka wejściowa wiersza.
columnInputCell
string
komórka wejściowa kolumny.
values
object[][]
wartości dla komórek w zakresie formuły tabeli.
SetTableFormula(int, int, string, bool, object[][])
Tworzy tabelę danych z jedną zmienną dla podanego zakresu zaczynając od tej komórki.
public void SetTableFormula(int rowNumber, int columnNumber, string inputCell, bool isRowInput, object[][] values)
Parametry
rowNumber
int
Liczba wierszy do wypełnienia formułą.
columnNumber
int
Liczba kolumn do wypełnienia formułą.
inputCell
string
komórka wejściowa.
isRowInput
bool
Wskazuje, czy komórka wejściowa jest komórką wejściową wiersza (prawda) czy komórką wejściową kolumny (fałsz).
values
object[][]
wartości dla komórek w zakresie formuły tabeli.
SetTableFormula(int, int, int, int, int, int, object[][])
Tworzy tabelę danych z dwoma zmiennymi dla podanego zakresu zaczynając od tej komórki.
public void SetTableFormula(int rowNumber, int columnNumber, int rowIndexOfRowInputCell, int columnIndexOfRowInputCell, int rowIndexOfColumnInputCell, int columnIndexOfColumnInputCell, object[][] values)
Parametry
rowNumber
int
Liczba wierszy do wypełnienia formułą.
columnNumber
int
Liczba kolumn do wypełnienia formułą.
rowIndexOfRowInputCell
int
indeks wiersza komórki wejściowej wiersza.
columnIndexOfRowInputCell
int
indeks kolumny komórki wejściowej wiersza.
rowIndexOfColumnInputCell
int
indeks wiersza komórki wejściowej kolumny.
columnIndexOfColumnInputCell
int
indeks kolumny komórki wejściowej kolumny.
values
object[][]
wartości dla komórek w zakresie formuły tabeli.
SetTableFormula(int, int, int, int, bool, object[][])
Tworzy tabelę danych z jedną zmienną dla podanego zakresu zaczynając od tej komórki.
public void SetTableFormula(int rowNumber, int columnNumber, int rowIndexOfInputCell, int columnIndexOfInputCell, bool isRowInput, object[][] values)
Parametry
rowNumber
int
Liczba wierszy do wypełnienia formułą.
columnNumber
int
Liczba kolumn do wypełnienia formułą.
rowIndexOfInputCell
int
indeks wiersza komórki wejściowej.
columnIndexOfInputCell
int
indeks kolumny komórki wejściowej.
isRowInput
bool
Wskazuje, czy komórka wejściowa jest komórką wejściową wiersza (prawda) czy komórką wejściową kolumny (fałsz).
values
object[][]
wartości dla komórek w zakresie formuły tabeli.
ToJson()
Konwertuje Aspose.Cells.Cell na dane strukturalne JSON.
public string ToJson()
Zwraca
ToString()
Zwraca ciąg reprezentujący bieżący obiekt Cell.
public override string ToString()