Class Cell

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

objectCell

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

bool

Column

Zwraca numer kolumny (indeks oparty na zerze) komórki.

public int Column { get; }

Wartość właściwości

int

Comment

Zwraca komentarz tej komórki.

public Comment Comment { get; }

Wartość właściwości

Comment

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

bool

DateTimeValue

Zwraca wartość DateTime zawartą w komórce.

public DateTime DateTimeValue { get; }

Wartość właściwości

DateTime

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

string

DoubleValue

Zwraca wartość zmiennoprzecinkową zawartą w komórce.

public double DoubleValue { get; }

Wartość właściwości

double

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

float

Formula

Zwraca lub ustawia formułę Aspose.Cells.Cell.

public string Formula { get; set; }

Wartość właściwości

string

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

string

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

bool

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

string

IntValue

Zwraca wartość całkowitą zawartą w komórce.

public int IntValue { get; }

Wartość właściwości

int

IsArrayFormula

Wskazuje, czy formuła komórki jest formułą tablicową.

public bool IsArrayFormula { get; }

Wartość właściwości

bool

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

bool

IsCheckBoxStyle

Wskazuje, czy ustawienie tej komórki jako pola wyboru.

public bool IsCheckBoxStyle { get; set; }

Wartość właściwości

bool

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

bool

IsErrorValue

Sprawdza, czy wartość tej komórki jest błędem.

public bool IsErrorValue { get; }

Wartość właściwości

bool

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

bool

IsMerged

Sprawdza, czy komórka jest częścią połączonego zakresu.

public bool IsMerged { get; }

Wartość właściwości

bool

IsNumericValue

Wskazuje, czy wartość tej komórki jest numeryczna (int, double i datetime).

public bool IsNumericValue { get; }

Wartość właściwości

bool

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

bool

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

bool

IsTableFormula

Wskazuje, czy ta komórka jest częścią formuły tabeli.

public bool IsTableFormula { get; }

Wartość właściwości

bool

Name

Zwraca nazwę komórki.

public string Name { get; }

Wartość właściwości

string

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

NumberCategoryType

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

string

Row

Zwraca numer wiersza (indeks oparty na zerze) komórki.

public int Row { get; }

Wartość właściwości

int

SharedStyleIndex

Zwraca indeks współdzielonego stylu komórki w puli stylów.

public int SharedStyleIndex { get; }

Wartość właściwości

int

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

string

Type

Reprezentuje typ wartości komórki.

public CellValueType Type { get; }

Wartość właściwości

CellValueType

Value

Zwraca/ustawia wartość zawartą w tej komórce.

public object Value { get; set; }

Wartość właściwości

object

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

Worksheet

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

FontSetting

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

bool

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

bool

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

CellArea

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

FontSetting[]

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

FontSetting[]

Wszystkie obiekty Characters.

GetConditionalFormattingResult()

Zwraca wynik formatowania warunkowego.

public ConditionalFormattingResult GetConditionalFormattingResult()

Zwraca

ConditionalFormattingResult

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

IEnumerator

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

Style

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

Style

GetFormatConditions()

Zwraca warunki formatowania, które mają zastosowanie do tej komórki.

public FormatConditionCollection[] GetFormatConditions()

Zwraca

FormatConditionCollection[]

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

string

formuła tej komórki.

GetHashCode()

Służy jako funkcja haszująca dla danego typu.

public override int GetHashCode()

Zwraca

int

Kod haszujący dla bieżącego obiektu Cell.

GetHeightOfValue()

Zwraca wysokość wartości w jednostkach pikseli.

public int GetHeightOfValue()

Zwraca

int

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

string

GetMergedRange()

Zwraca obiekt Aspose.Cells.Range, który reprezentuje połączony zakres.

public Range GetMergedRange()

Zwraca

Range

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

ReferredAreaCollection

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

IEnumerator

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

CellRichValue

GetStringValue(CellValueFormatStrategy)

Zwraca wartość ciągu według określonej strategii formatowania.

public string GetStringValue(CellValueFormatStrategy formatStrategy)

Parametry

formatStrategy CellValueFormatStrategy

Strategia formatowania.

Zwraca

string

GetStyle()

Zwraca styl komórki.

public Style GetStyle()

Zwraca

Style

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

Style

Obiekt stylu.

GetTable()

Zwraca tabelę, która zawiera tę komórkę.

public ListObject GetTable()

Zwraca

ListObject

GetValidation()

Zwraca walidację zastosowaną do tej komórki.

public Validation GetValidation()

Zwraca

Validation

GetValidationValue()

Zwraca wartość walidacji, która została zastosowana do tej komórki.

public bool GetValidationValue()

Zwraca

bool

GetWidthOfValue()

Zwraca szerokość wartości w jednostkach pikseli.

public int GetWidthOfValue()

Zwraca

int

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

bool

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

CellArea

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

CellArea

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

CellArea

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

string

ToString()

Zwraca ciąg reprezentujący bieżący obiekt Cell.

public override string ToString()

Zwraca

string

 Polski