این صفحه به‌وسیله ‏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 - این سازنده، برای زنجیره زدن