SerializeField 序列化域

Inherits from Attribute

Force Unity to serialize a private field.

强制Unity去序列化一个私有域。

You will almost never need this. When Unity serializes your scripts, it will only serialize public fields. If in addition to that you also want Unity to serialize one of your private fields you can add the SerializeField attribute to the field.

你几乎从来不需要它。当Unity序列化你的脚本的时候，它将紧紧序列化公有域。如果作为附加你也想要Unity去序列化你的一个私有域，你可以添加SerializeField（序列化域）属性给这个域。

Unity will serialize all your script components, reload the new assemblies, and recreate your script components from the serialized verions. This serialization does not happen with .NET's serialization functionality, but with an internal Unity one.

Unity将序列化所有你的脚本组件，重载新的集合，并且重新创建你的脚本组件从这个序列化版本。这个序列化不会发生通过.Net的序列化功能，而是用一个内部的Unity序列化功能。

The serialization system used can do the following:

这个序列化系统使用可以做以下事情：

- CAN serialize public nonstatic fields (of serializable types)
- 可以序列化公有的非静态域（序列化类型的）

- CAN serialize nonpublic nonstatic fields marked with the [SerializeField] attribute.
- 可以序列化非公有非静态域用[SerializeField]属性标记。

- CANNOT serialize static fields.
- 不可以序列化静态域。

- CANNOT serialize properties.
- 不可以序列化属性。

Your field will only serialize if it is of a type that Unity can serialize:

你的域将紧紧序列化如果他是Unity可以序列化的一种类型。

Serializable types are:
序列化的类型有：

- All classed inheriting from UnityEngine.Object, for example Gameobject, Commponent, MonoBehaviour, Texture2D, AnimationClip.. - All basic data types like int, string, float, bool. - Some built in types like Vector2, Vector3, Vector4, Quaternion, Matrix4x4, Color, Rect, Layermask.. - Arrays of a serializable type
- 所有继承自UnityEngine.Object的类，例如GameObject,Component,MonoBehaviour,Texture2D,AnimationClip..- 所有基本类型像int,string,float,bool.- 一些内建类型像Vector2,Vector3,Vector4,Quaternion,Matrix4x4,Color,Rect,Layermask..- 一个序列化类型的Array（数组）

- List of a serializable type (new in Unity2.6)
- 一个序列化类型的列表（新的在Unity2.6）

- Enums
- 枚举。

Headsup note: if you put one element in a list (or array) twice, when the list gets serialized, you'll get two copies of that element, instead of one copy being in the new list twice.

特别注意：如果你放一个元素在一个列表（或者数组）两次，当列表被序列化的时候，你将得到两个这个元素的拷贝，而不是一个拷贝两次在新的列表。

Hint: Unity won't serialize Dictionary, however you could store a Listf<> or keys and a List<> for values, and sew them up in a non serialized dictionary on Awake(). This doesn't solve the problem of when you want to modify the dictionary and have it "saved" back, but it is a handy trick in a lot of other cases.

暗示：Unity不会序列化Dictionary（字典），然而你可以存储一个列表给键，一个列表给值，并且缝合他们在一个非序列化dictionary（字典）在Awake()。这不会解决当你想要修改dictionary（字典）和让它的"被保存"返回的问题，但是它在很多其他的情况里是一个便利的窍门。

For UnityScript users: Fields in c# is a script variable in UnityScript, and [SerializeField] becomes @SerializeField. [Serializable] on a class becomes @script Serializable in a UnityScript

给UnityScript用户：C#中的域在UnityScript中是一个脚本变量，并且[SerializeField]变成@SerializeField。[Serializable] 在一个类上变成@script Serializable在一个UnityScript。

// Javascript example

//This field gets serialized because it is public.
//这个域被序列化因为他是公开的。
var name = "John";

//This field does not get serialized because it is private.
//这个域没有被序列化因为它是私有的。
private var age = 40;

//This field gets serialized even though it is private
//这个域被序列化尽管他是私有的。
//because it has the SerializeField attribute applied.
//因为它应用了SerializeField属性
@SerializeField
private var hasHealthPotion:boolean = true;

function Update () {
}

//C# example
using UnityEngine;

public class SomePerson : MonoBehaviour {
	//This field gets serialized because it is public.
	public string name = "John";

	//This field does not get serialized because it is private.
	private int age = 40;

	//This field gets serialized even though it is private
	//because it has the SerializeField attribute applied.
	[SerializeField]
	private bool hasHealthPotion = true;

	void Update () {
	}
}