IronXL ile C#'ta İsimlendirilen Aralık Nasıl Eklenir
Bir isimlendirilen aralık, benzersiz bir isimle tanımlanan hücrelerin belirli bir aralığıdır. Bir aralığa hücre adresleri (A1:B10 gibi) ile atıfta bulunmak yerine, bir aralığa isim atayarak formüller ve fonksiyonlarda anlaşılmasını ve referans edilmesini kolaylaştırabilirsiniz. Ornegin, bir araliga 'SalesData' adini verirseniz, hucre araligini dogrudan belirtmek yerine onu bir SUM(SalesData) formulünde referans olarak kullanabilirsiniz.
İsimlendirilen aralıklar, kodunuzu daha okunabilir ve sürdürülebilir hale getirmek açısından C#'ta Excel formülleri ile çalışırken özellikle kullanışlıdır. IronXL'ın güçlü aralık seçimi yetenekleri ile birleştirildiğinde, isimlendirilen aralıklar verimli elektronik tablo yönetimi için temel bir araç haline gelir.
Hızlı Başlangıç: IronXL ile Tek Satırda İsimlendirilen Aralık Ekleyin
Tek bir yöntem çağrısıyla IronXL kullanarak bir isimlendirilen aralık tanımlayın. Aradiginiz araligi secin ve SaveAsNamedRange metodunu uygulayin.
-
NuGet Paket Yöneticisi ile https://www.nuget.org/packages/IronXl.Excel yükleyin
PM > Install-Package IronXl.Excel -
Bu kod parçasını kopyalayıp çalıştırın.
new IronXl.WorkBook() .DefaultWorkSheet["A1:B2"].SaveAsNamedRange("MyRange", true); -
Canlı ortamınızda test etmek için dağıtın
Bugün projenizde IronXL kullanmaya başlayın ücretsiz deneme ile
Minimal Is Akisi (5 adimda)
- İsimlendirilen aralıklar eklemek için C# kütüphanesini indirin
workSheet["A1:A5"]ile hedef aralığı seçin- İsimlendirilen aralıklar eklemek için
AddNamedRangeyöntemini kullanın - İsimlendirilen aralığı çeşitli yollarla alın
RemoveNamedRangeyöntemiyle isimlendirilen aralığı kolayca kaldırın
Çalışma Sayfama Nasıl İsimlendirilen Aralık Eklerim?
Adlandirilmis bir aralik eklemek icin, adlandirilmis araligin adini metin olarak ve aralik nesnesini gondererek AddNamedRange metodunu kullanin. Bu yöntem, IronXL'ın kapsamlı çalışma sayfası yönetim özelliklerinin bir parçasıdır.
:path=/static-assets/excel/content-code-examples/how-to/named-range-add-named-range.cs
using IronXL;
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.DefaultWorkSheet;
// Select range
var selectedRange = workSheet["A1:A5"];
// Add named range
workSheet.AddNamedRange("range1", selectedRange);
workBook.SaveAs("addNamedRange.xlsx");
Imports IronXL
Private workBook As WorkBook = WorkBook.Create()
Private workSheet As WorkSheet = workBook.DefaultWorkSheet
' Select range
Private selectedRange = workSheet("A1:A5")
' Add named range
workSheet.AddNamedRange("range1", selectedRange)
workBook.SaveAs("addNamedRange.xlsx")
İsimlendirilen aralıklar oluştururken, Excel'in isimlendirme kurallarına uymak önemlidir:
- İsimler bir harf veya alt çizgi (underscore) ile başlamalıdır
- İsimler boşluk içeremez (bunun yerine alt çizgi kullanın)
- İsimler hücre referanslarıyla ("A1" veya "R1C1" gibi) çelişmemelidir
- İsimler büyük/küçük harfe duyarlı değildir ancak tutarlı harf kullanımı okunabilirliği artırır
İsimlendirilen aralıklar, bitişik olmayan seçimler veya tam satır/sütunlar için de oluşturulabilir. Daha karmaşık aralık işlemleri için, birden fazla Excel aralığını birleştirme kılavuzuna göz atın.
Çalışma Kitabımdan İsimlendirilen Aralıkları Nasıl Alabilirim?
Tüm İsimlendirilen Aralıkları Bir Anda Hangi Yöntem Alır?
GetNamedRanges metodu, calisma sayfasindaki tüm adlandirilmis araliklari bir string listesi olarak dondurur. Bu, özellikle bir çalışma kitabındaki tüm isimlendirilen aralıkları denetlemek veya belgelemek gerektiğinde kullanışlıdır, mevcut çalışma kitaplarını yükleyip yapısını analiz ettiğinizdeki gibi.
:path=/static-assets/excel/content-code-examples/how-to/named-range-retrieve-all-named-range.cs
using IronXL;
WorkBook workBook = WorkBook.Load("addNamedRange.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;
// Get all named range
var namedRangeList = workSheet.GetNamedRanges();
Imports IronXL
Private workBook As WorkBook = WorkBook.Load("addNamedRange.xlsx")
Private workSheet As WorkSheet = workBook.DefaultWorkSheet
' Get all named range
Private namedRangeList = workSheet.GetNamedRanges()
Belirli Bir İsimlendirilen Aralığı İsme Göre Nasıl Bulabilirim?
Adlandirilmis araligin mutlak referansini elde etmek icin FindNamedRange metodunu kullanin, ornegin Sheet1!$A$1:$A$5. Adres formülü, isimlendirilen aralığa atıfta bulunmak veya isimlendirilen aralık ile ilgili aralığı seçmek için kullanılabilir. Aralığı seçerken çalışma sayfası adına dikkat etmelisiniz.
:path=/static-assets/excel/content-code-examples/how-to/named-range-retrieve-specific-named-range.cs
using IronXL;
WorkBook workBook = WorkBook.Load("addNamedRange.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;
// Get named range address
string namedRangeAddress = workSheet.FindNamedRange("range1");
// Select range
var range = workSheet[$"{namedRangeAddress}"];
Imports IronXL
Private workBook As WorkBook = WorkBook.Load("addNamedRange.xlsx")
Private workSheet As WorkSheet = workBook.DefaultWorkSheet
' Get named range address
Private namedRangeAddress As String = workSheet.FindNamedRange("range1")
' Select range
Private range = workSheet($"{namedRangeAddress}")
Birden Fazla Çalışma Sayfasında İsimlendirilen Aralıklarla Çalışma
İsimlendirilen aralıklar, çalışma kitabı seviyesinde veya çalışma sayfası seviyesinde kullanılabilir. Çalışma kitabı seviyesindeki isimler herhangi bir çalışma sayfasından erişilebilirken, çalışma sayfası seviyesindeki isimler yalnızca kendi belirli çalışma sayfalarında erişilebilir. Bu ayrım, Excel dosyalarınızda birden fazla çalışma sayfasını yönetirken önemlidir.
// Example: Accessing named ranges from different worksheets
WorkBook workBook = WorkBook.Load("multisheet.xlsx");
WorkSheet sheet1 = workBook.GetWorkSheet("Sheet1");
WorkSheet sheet2 = workBook.GetWorkSheet("Sheet2");
// Both can access a workbook-level named range
var range1 = sheet1["GlobalData"];
var range2 = sheet2["GlobalData"]; // Same named range
// Example: Accessing named ranges from different worksheets
WorkBook workBook = WorkBook.Load("multisheet.xlsx");
WorkSheet sheet1 = workBook.GetWorkSheet("Sheet1");
WorkSheet sheet2 = workBook.GetWorkSheet("Sheet2");
// Both can access a workbook-level named range
var range1 = sheet1["GlobalData"];
var range2 = sheet2["GlobalData"]; // Same named range
Imports System
' Example: Accessing named ranges from different worksheets
Dim workBook As WorkBook = WorkBook.Load("multisheet.xlsx")
Dim sheet1 As WorkSheet = workBook.GetWorkSheet("Sheet1")
Dim sheet2 As WorkSheet = workBook.GetWorkSheet("Sheet2")
' Both can access a workbook-level named range
Dim range1 = sheet1("GlobalData")
Dim range2 = sheet2("GlobalData") ' Same named range
Çalışma Sayfamdan İsimlendirilen Aralığı Nasıl Kaldırırım?
Adlandirilmis araligi kaldirmak icin, adlandirilmis aralik adini metin olarak gondererek RemoveNamedRange metodunu kullanin. Bu, düzenli ve organize çalışma kitaplarını sürdürmek ve elektronik tablo yapılarını güncellerken isim çakışmalarını önlemek için önemlidir.
:path=/static-assets/excel/content-code-examples/how-to/named-range-remove-named-range.cs
using IronXL;
WorkBook workBook = WorkBook.Load("addNamedRange.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;
// Remove named range
workSheet.RemoveNamedRange("range1");
Imports IronXL
Private workBook As WorkBook = WorkBook.Load("addNamedRange.xlsx")
Private workSheet As WorkSheet = workBook.DefaultWorkSheet
' Remove named range
workSheet.RemoveNamedRange("range1")
İleri Düzey İsimlendirilen Aralık Senaryoları
Formüllerle İsimlendirilen Aralıklar Kullanımı
İsimlendirilen aralıklar, Excel formülleriyle kullanıldığında gerçekten parlar. Formülleri daha okunabilir ve daha kolay bakım yapmayı sağlar. Kapsamlı formül yönetimi için, C#'ta Excel formülleri kılavuzuna bakın.
// Create named ranges for formula use
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.DefaultWorkSheet;
// Create sample data
workSheet["A1:A5"].Value = new int[] { 10, 20, 30, 40, 50 };
workSheet["B1:B5"].Value = new int[] { 5, 10, 15, 20, 25 };
// Add named ranges
workSheet.AddNamedRange("FirstColumn", workSheet["A1:A5"]);
workSheet.AddNamedRange("SecondColumn", workSheet["B1:B5"]);
// Use named ranges in formulas
workSheet["D1"].Formula = "=SUM(FirstColumn)";
workSheet["D2"].Formula = "=AVERAGE(SecondColumn)";
workSheet["D3"].Formula = "=SUM(FirstColumn) + SUM(SecondColumn)";
// Evaluate formulas
workSheet.EvaluateAll();
// Create named ranges for formula use
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.DefaultWorkSheet;
// Create sample data
workSheet["A1:A5"].Value = new int[] { 10, 20, 30, 40, 50 };
workSheet["B1:B5"].Value = new int[] { 5, 10, 15, 20, 25 };
// Add named ranges
workSheet.AddNamedRange("FirstColumn", workSheet["A1:A5"]);
workSheet.AddNamedRange("SecondColumn", workSheet["B1:B5"]);
// Use named ranges in formulas
workSheet["D1"].Formula = "=SUM(FirstColumn)";
workSheet["D2"].Formula = "=AVERAGE(SecondColumn)";
workSheet["D3"].Formula = "=SUM(FirstColumn) + SUM(SecondColumn)";
// Evaluate formulas
workSheet.EvaluateAll();
' Create named ranges for formula use
Dim workBook As WorkBook = WorkBook.Create()
Dim workSheet As WorkSheet = workBook.DefaultWorkSheet
' Create sample data
workSheet("A1:A5").Value = New Integer() {10, 20, 30, 40, 50}
workSheet("B1:B5").Value = New Integer() {5, 10, 15, 20, 25}
' Add named ranges
workSheet.AddNamedRange("FirstColumn", workSheet("A1:A5"))
workSheet.AddNamedRange("SecondColumn", workSheet("B1:B5"))
' Use named ranges in formulas
workSheet("D1").Formula = "=SUM(FirstColumn)"
workSheet("D2").Formula = "=AVERAGE(SecondColumn)"
workSheet("D3").Formula = "=SUM(FirstColumn) + SUM(SecondColumn)"
' Evaluate formulas
workSheet.EvaluateAll()
Dinamik İsimlendirilen Aralıklar
IronXL doğrudan Excel'in dinamik isimlendirilen aralıklarını (OFFSET veya INDEX fonksiyonlarını kullanarak) desteklemese de, veride yapılan değişikliklere göre isimlendirilen aralıkları programlı olarak güncelleyebilirsiniz:
// Update named range based on data size
WorkBook workBook = WorkBook.Load("dynamicData.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;
// Find last row with data
int lastRow = 1;
while (!workSheet[$"A{lastRow}"].IsEmpty)
{
lastRow++;
}
lastRow--; // Adjust to actual last row
// Remove old range and add new one
workSheet.RemoveNamedRange("DataRange");
workSheet.AddNamedRange("DataRange", workSheet[$"A1:A{lastRow}"]);
// Update named range based on data size
WorkBook workBook = WorkBook.Load("dynamicData.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;
// Find last row with data
int lastRow = 1;
while (!workSheet[$"A{lastRow}"].IsEmpty)
{
lastRow++;
}
lastRow--; // Adjust to actual last row
// Remove old range and add new one
workSheet.RemoveNamedRange("DataRange");
workSheet.AddNamedRange("DataRange", workSheet[$"A1:A{lastRow}"]);
Imports IronXL
' Update named range based on data size
Dim workBook As WorkBook = WorkBook.Load("dynamicData.xlsx")
Dim workSheet As WorkSheet = workBook.DefaultWorkSheet
' Find last row with data
Dim lastRow As Integer = 1
While Not workSheet($"A{lastRow}").IsEmpty
lastRow += 1
End While
lastRow -= 1 ' Adjust to actual last row
' Remove old range and add new one
workSheet.RemoveNamedRange("DataRange")
workSheet.AddNamedRange("DataRange", workSheet($"A1:A{lastRow}"))
Veri Doğrulama için İsimlendirilen Aralıklar
İsimlendirilen aralıklar, veri doğrulama listeleri ve kısıtlamaları oluşturmak için mükemmeldir. Excel'in veri doğrulama özellikleri ile birleştirildiğinde, veri bütünlüğünü sağlamak için güçlü bir yol sunarlar:
// Create a named range for validation list
workSheet["F1:F5"].Value = new string[] { "Option1", "Option2", "Option3", "Option4", "Option5" };
workSheet.AddNamedRange("ValidationList", workSheet["F1:F5"]);
// Apply to data validation (conceptual example)
// The actual validation would reference "ValidationList"
// Create a named range for validation list
workSheet["F1:F5"].Value = new string[] { "Option1", "Option2", "Option3", "Option4", "Option5" };
workSheet.AddNamedRange("ValidationList", workSheet["F1:F5"]);
// Apply to data validation (conceptual example)
// The actual validation would reference "ValidationList"
' Create a named range for validation list
workSheet("F1:F5").Value = New String() {"Option1", "Option2", "Option3", "Option4", "Option5"}
workSheet.AddNamedRange("ValidationList", workSheet("F1:F5"))
' Apply to data validation (conceptual example)
' The actual validation would reference "ValidationList"
En İyi Uygulamalar ve Performans İpuçları
- Adlandirma Kurallari: Verinin amacini belirten tanimlayici, tutarli adlar kullanin (ornegin, 'Data1' yerine
Sales_Q1_2024) - Kapsam Yönetimi: Çatışmaları önlemek için çalışma kitabı ve çalışma sayfası kapsamı hakkında kasıtlı olun
- Belgeler: Özellikle karmaşık çalışma kitaplarında, isimlendirilen aralıkların ve amaçlarının bir listesini tutun
- Performans: İsimlendirilen aralıklar, minimal performans etkisine sahiptir, ancak binlerce küçük isimlendirilen aralık oluşturmaktan kaçının
- Güncellemeler: Veri yapıları değiştiğinde, doğruluğu korumak için ilgili isimlendirilen aralıkları güncelleyin veya kaldırın
Daha gelişmiş Excel işlemleri ve performans optimizasyonu için kapsamlı IronXL belgelerini veya Excel aralıklarını sıralama veya Excel tablolarıyla çalışma gibi belirli özelliklere göz atın.
Sıkça Sorulan Sorular
C# kullanarak Excel'de adlandırılmış bir aralığı nasıl oluştururum?
C#'de IronXL ile Excel'de adlandırılmış bir aralık oluşturmak için, hedef aralığınızı çalışma sayfası indeksleyici (örneğin, workSheet["A1:B2"]) kullanarak seçin ve ardından istediğiniz adla SaveAsNamedRange yöntemini çağırın. Ayrıca metni ad olarak geçirerek ve Aralık nesnesini kullanarak AddNamedRange yöntemini de kullanabilirsiniz.
Excel adlandırılmış aralıkları için ad koyma kuralları nelerdir?
IronXL kullanarak adlandırılmış aralıklar oluştururken şu Excel ad koyma kurallarını izleyin: Adlar bir harf veya alt çizgi ile başlamalı, boşluk içeremez (yerine alt çizgiler kullanın), 'A1' gibi hücre referanslarıyla çakışmamalı ve büyük/küçük harf duyarsızdır. IronXL, adlandırılmış aralıklar oluşturduğunuzda bu kuralları otomatik olarak uygular.
Bir Excel çalışma kitabından programatik olarak tüm adlandırılmış aralıkları alabilir miyim?
Evet, IronXL, çalışma sayfasındaki tüm adlandırılmış aralıkları bir dize listesi olarak döndüren GetNamedRanges yöntemini sağlar. Bu özellik, IronXL ile yüklenen mevcut çalışma kitaplarındaki adlandırılmış aralıkları denetlerken veya belgelerken özellikle kullanışlıdır.
Adlandırılmış aralıklar Excel formüllerimi C#'de nasıl geliştirebilir?
Adlandırılmış aralıklar, IronXL ile çalışırken Excel formüllerini daha okunabilir ve sürdürülebilir hale getirir. 'A1:B10' gibi hücre referansları yerine formüllerinizde 'SalesData' gibi açıklayıcı adlar kullanarak C# kodunuzu daha anlaşılır ve anlaşılır hale getirebilirsiniz.
Bitişik olmayan hücreler için adlandırılmış aralıklar oluşturmak mümkün müdür?
Evet, IronXL, bitişik olmayan seçimler ve tüm satırlar veya sütunlar için adlandırılmış aralıklar oluşturmayı destekler. Kütüphanenin kapsamlı çalışma sayfası yönetim özellikleri, basit dikdörtgen seçimlerin ötesinde karmaşık adlandırılmış aralıklar tanımlamanıza olanak tanır.
Tek bir kod satırında adlandırılmış bir aralığı eklemenin en hızlı yolu nedir?
IronXL ile, şu satırı kullanarak tek bir ad satırında adlandırılmış bir aralık oluşturabilirsiniz: new IronXl.WorkBook().DefaultWorkSheet["A1:B2"].SaveAsNamedRange("MyRange", true). Bu, IronXL'in Excel manipülasyonu için sadeleştirilmiş API'sini göstermektedir.
Excel çalışma sayfasından adlandırılmış aralıkları nasıl kaldırırım?
IronXL, çalışma sayfanızdan adlandırılmış aralıkları kolayca silmek için RemoveNamedRange yöntemini sağlar. Bu, kütüphanenin eksiksiz adlandırılmış aralık yönetim yeteneklerinden biridir ve programatik olarak adlandırılmış aralıklar eklemenize, almanıza ve kaldırmanıza olanak tanır.

