این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

Class DataTableBuilder

سازنده اشیاء DataTable. ساخت یک جدول داده شامل ابتدا مشخص کردن ستون‌های آن و سپس اضافه کردن ردیف‌های آن در یک زمان است. مثال:

var data = Charts.newDataTable()
    .addColumn(Charts.ColumnType.STRING, "Month")
    .addColumn(Charts.ColumnType.NUMBER, "In Store")
    .addColumn(Charts.ColumnType.NUMBER, "Online")
    .addRow(["January", 10, 1])
    .addRow(["February", 12, 1])
    .addRow(["March", 20, 2])
    .addRow(["April", 25, 3])
    .addRow(["May", 30, 4])
    .build();

روش ها

روش	نوع برگشت	شرح مختصر
`addColumn(type, label)`	`DataTableBuilder`	یک ستون به جدول داده ها اضافه می کند.
`addRow(values)`	`DataTableBuilder`	یک ردیف به جدول داده ها اضافه می کند.
`build()`	`DataTable`	جدول داده را می سازد و برمی گرداند.
`setValue(row, column, value)`	`DataTableBuilder`	مقدار خاصی را در جدول تعیین می کند.

مستندات دقیق

`addColumn(type, label)`

یک ستون به جدول داده ها اضافه می کند. ستون ها از 0 تا n اضافه خواهند شد.

ستون اول اغلب توسط نمودارها برای برچسب ها استفاده می شود (به عنوان مثال، برچسب های محور X در نمودارهای خطی، یا برچسب های برش در نمودارهای دایره ای). ستون های دیگر اغلب برای داده ها استفاده می شوند و بنابراین اغلب به مقادیر عددی نیاز دارند.

پارامترها

نام	تایپ کنید	توضیحات
`type`	`ColumnType`	نوع داده در ستون (عدد، رشته یا تاریخ)
`label`	`String`	برچسب ستون (برای افسانه های نمودار استفاده می شود).

بازگشت

DataTableBuilder - این سازنده، برای زنجیره زدن.

`addRow(values)`

یک ردیف به جدول داده ها اضافه می کند.

پارامترها

نام	تایپ کنید	توضیحات
`values`	`Object[]`	مقادیر برای سطر، به همان ترتیبی که ستون‌ها وارد می‌شوند مشخص شده‌اند.

بازگشت

DataTableBuilder - این سازنده، برای زنجیره زدن.

`build()`

جدول داده را می سازد و برمی گرداند.

بازگشت

DataTable - جدول داده ها

پرتاب می کند

Error - اگر جدول داده ها خالی یا بد شکل باشد

`setValue(row, column, value)`

مقدار خاصی را در جدول تعیین می کند.

می توانید قبل از اضافه کردن ستون به جدول داده ها، مقداری را تعیین کنید. با این حال، مگر اینکه ستون در نقطه ای اضافه شود، مقدار نادیده گرفته می شود.

همه مقادیر ستون نیازی به پر کردن null .

پارامترها

نام	تایپ کنید	توضیحات
`row`	`Integer`	شاخص ردیف (ردیف اول دارای شاخص 0 است)
`column`	`Integer`	نمایه ستون (ستون اول دارای شاخص 0 است)
`value`	`Object`	مقدار سلول جدول (باید نوع مناسب ستون را داشته باشد).

بازگشت

DataTableBuilder - این سازنده، برای زنجیره زدن