<متا داده>
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
- نحو:
<meta-data android:name="string"
android:resource="resource specification"
android:value="string" />- موجود در:
-
<activity>
<activity-alias>
<application>
<provider>
<receiver>
<service> - توضیحات:
- یک جفت نام-مقدار برای یک مورد از داده‌های دلخواه اضافی که می‌تواند به مؤلفه والد ارائه شود. یک عنصر کامپوننت می‌تواند حاوی هر تعداد از عناصر فرعی
<meta-data> باشد. مقادیر همه آنها در یک شیء Bundle جمع آوری شده و به عنوان فیلد PackageItemInfo.metaData در دسترس مؤلفه قرار می گیرد. مقادیر معمولی را از طریق ویژگی value مشخص کنید. برای اختصاص شناسه منبع به عنوان مقدار، به جای آن از ویژگی resource استفاده کنید. به عنوان مثال، کد زیر هر مقداری که در منبع @string/kangaroo ذخیره شده است را به نام zoo اختصاص می دهد:
<meta-data android:name="zoo" android:value="@string/kangaroo" />
از سوی دیگر، با استفاده از ویژگی resource zoo شناسه عددی منبع را به آن اختصاص می دهد، نه مقدار ذخیره شده در منبع:
<meta-data android:name="zoo" android:resource="@string/kangaroo" />
ما به شدت توصیه می کنیم که از ارائه داده های مرتبط به عنوان چندین ورودی <meta-data> جدا خودداری کنید. در عوض، اگر داده‌های پیچیده‌ای برای مرتبط کردن با یک مؤلفه دارید، آن را به عنوان یک منبع ذخیره کنید و از ویژگی resource برای اطلاع دادن مؤلفه از شناسه آن استفاده کنید.
- صفات:
-
android:name - یک نام منحصر به فرد برای کالا برای منحصر به فرد نگه داشتن نام، از یک قرارداد نامگذاری به سبک جاوا، مانند "
com.example.project.activity.fred " استفاده کنید. -
android:resource - ارجاع به یک منبع شناسه منبع مقداری است که به آیتم اختصاص داده شده است. شناسه با استفاده از متد
Bundle.getInt() از Bundle متا داده بازیابی می شود. -
android:value - مقدار اختصاص داده شده به مورد. انواع داده هایی که می توانند به عنوان مقادیر اختصاص داده شوند و روش های
Bundle که کامپوننت ها برای بازیابی آن مقادیر استفاده می کنند در جدول زیر فهرست شده اند:
| تایپ کنید | روش باندل |
|---|
رشته: برای فرار از کاراکترها از بک اسلش های دوتایی ( \\ ) استفاده کنید، مانند \\n برای یک خط جدید و \\uxxxxx برای یک کاراکتر یونیکد | getString() |
عدد صحیح: برای مثال 100 | getInt() |
بولی: یا true یا false | getBoolean() |
رنگ: به شکل #rgb ، #argb ، #rrggbb ، یا #aarrggbb | getInt() |
Float: به عنوان مثال، 1.23 | getFloat() |
- معرفی شده در:
- API سطح 1
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# <meta-data\u003e\n\nsyntax:\n:\n\n ```xml\n \u003cmeta-data android:name=\"string\"\n android:resource=\"resource specification\"\n android:value=\"string\" /\u003e\n ```\n\ncontained in:\n: [\u003cactivity\u003e](/guide/topics/manifest/activity-element)\n\n [\u003cactivity-alias\u003e](/guide/topics/manifest/activity-alias-element)\n\n [\u003capplication\u003e](/guide/topics/manifest/application-element)\n\n [\u003cprovider\u003e](/guide/topics/manifest/provider-element)\n\n [\u003creceiver\u003e](/guide/topics/manifest/receiver-element)\n\n [\u003cservice\u003e](/guide/topics/manifest/service-element)\n\ndescription:\n: A name-value pair for an item of additional, arbitrary data that can be\n supplied to the parent component. A component element can contain any\n number of `\u003cmeta-data\u003e` subelements. The values from all of\n them are collected in a single [Bundle](/reference/android/os/Bundle) object and made\n available to the component as the\n [PackageItemInfo.metaData](/reference/android/content/pm/PackageItemInfo#metaData) field.\n\n Specify ordinary values through the [value](/guide/topics/manifest/meta-data-element#val)\n attribute. To assign a resource ID as the value, use the\n [resource](/guide/topics/manifest/meta-data-element#rsrc) attribute instead. For example,\n the following code assigns whatever value is stored in the `@string/kangaroo`\n resource to the `zoo` name:\n\n\n ```xml\n \u003cmeta-data android:name=\"zoo\" android:value=\"@string/kangaroo\" /\u003e\n ```\n\n\n On the other hand, using the `resource` attribute assigns `zoo`\n the numeric ID of the resource, not the value stored in the resource:\n\n\n ```xml\n \u003cmeta-data android:name=\"zoo\" android:resource=\"@string/kangaroo\" /\u003e\n ```\n\n\n We highly recommend that you avoid supplying related data as\n multiple separate `\u003cmeta-data\u003e` entries. Instead, if you\n have complex data to associate with a component, store it as a resource and\n use the `resource` attribute to inform the component of its ID.\n\nattributes:\n:\n\n `android:name`\n : A unique name for the item. To keep the name unique, use a\n Java-style naming convention, such as\n \"`com.example.project.activity.fred`\".\n\n `android:resource`\n : A reference to a resource. The ID of the resource is the value assigned\n to the item. The ID is retrieved from the meta-data `Bundle` using the\n [Bundle.getInt()](/reference/android/os/BaseBundle#getInt(java.lang.String)) method.\n\n `android:value`\n : The value assigned to the item. The data types that can be assigned as values and the\n `Bundle` methods that components use to retrieve those values are listed in the following table:\n\n\n | Type | Bundle method |\n |---------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------|\n | String: use double backslashes (`\\\\`) to escape characters, such as `\\\\n` for a new line and `\\\\uxxxxx` for a Unicode character | [getString()](/reference/android/os/BaseBundle#getString(java.lang.String)) |\n | Integer: for example, `100` | [getInt()](/reference/android/os/BaseBundle#getInt(java.lang.String)) |\n | Boolean: either `true` or `false` | [getBoolean()](/reference/android/os/BaseBundle#getBoolean(java.lang.String)) |\n | Color: in the form `#rgb`, `#argb`, `#rrggbb`, or `#aarrggbb` | [getInt()](/reference/android/os/BaseBundle#getInt(java.lang.String)) |\n | Float: for example, `1.23` | [getFloat()](/reference/android/os/Bundle#getFloat(java.lang.String)) |\n\n\nintroduced in:\n: API level 1"]]
