NonSerializedAttribute 클래스
serializable 클래스의 필드를 serialize할 수 없음을 나타냅니다. 이 클래스는 상속될 수 없습니다.
네임스페이스: System
어셈블리: mscorlib(mscorlib.dll)
구문
‘선언
<AttributeUsageAttribute(AttributeTargets.Field, Inherited:=False)> _
<ComVisibleAttribute(True)> _
Public NotInheritable Class NonSerializedAttribute
Inherits Attribute
‘사용 방법
Dim instance As NonSerializedAttribute
[AttributeUsageAttribute(AttributeTargets.Field, Inherited=false)]
[ComVisibleAttribute(true)]
public sealed class NonSerializedAttribute : Attribute
[AttributeUsageAttribute(AttributeTargets::Field, Inherited=false)]
[ComVisibleAttribute(true)]
public ref class NonSerializedAttribute sealed : public Attribute
/** @attribute AttributeUsageAttribute(AttributeTargets.Field, Inherited=false) */
/** @attribute ComVisibleAttribute(true) */
public final class NonSerializedAttribute extends Attribute
AttributeUsageAttribute(AttributeTargets.Field, Inherited=false)
ComVisibleAttribute(true)
public final class NonSerializedAttribute extends Attribute
설명
BinaryFormatter 또는 SoapFormatter 클래스를 사용하여 개체를 serialize할 경우에는 필드가 serialize되지 않도록 NonSerializedAttribute 특성을 사용합니다. 예를 들어, 이 특성을 사용하여 중요한 데이터의 serialization을 방지할 수 있습니다.
NonSerializedAttribute 특성의 대상 개체는 serialize할 수 있는 클래스의 공용 및 전용 필드입니다. SerializableAttribute로 표시되지 않은 클래스는 기본적으로 serialize할 수 없습니다. 기본적으로 serialization을 수행하는 동안 클래스의 공용 필드와 전용 필드는 모두 serialize됩니다. NonSerializedAttribute로 표시된 필드는 serialization 중에 제외됩니다. XmlSerializer 클래스를 사용하여 개체를 serialize할 경우에는 XmlIgnoreAttribute 클래스를 사용하여 동일한 기능을 수행할 수 있습니다. 아니면 ISerializable 인터페이스를 구현하여 serialization 프로세스를 명시적으로 제어할 수 있습니다. ISerializable을 구현하는 클래스도 역시 SerializableAttribute로 표시해야 합니다.
이벤트에 NonSerializedAttribute 클래스를 적용하려면 다음 C# 코드와 같이 특성 위치를 필드로 설정합니다.
[field:NonSerializedAttribute()]
public event ChangedEventHandler Changed;
필드가 serialize되지 않았지만 deserialization 후에 제공해야 하는 기본값을 계속 필요로 하는 경우 필드에 값을 제공하는 메서드를 만든 다음 OnDeserializedAttribute를 메서드에 적용할 수 있습니다.
특성 사용에 대한 자세한 내용은 특성을 사용하여 메타데이터 확장을 참조하십시오.
예제
다음 예제에서는 SerializableAttribute 특성으로 표시된 개체의 serialization과 serialize된 개체에서 NonSerializedAttribute로 표시된 필드의 동작을 보여 줍니다.
Imports System
Imports System.IO
Imports System.Runtime.Serialization
Imports System.Runtime.Serialization.Formatters.Soap
Public Class Test
Public Shared Sub Main()
' Creates a new TestSimpleObject object.
Dim obj As New TestSimpleObject()
Console.WriteLine("Before serialization the object contains: ")
obj.Print()
' Opens a file and serializes the object into it in binary format.
Dim stream As Stream = File.Open("data.xml", FileMode.Create)
Dim formatter As New SoapFormatter()
formatter.Serialize(stream, obj)
stream.Close()
' Empties obj.
obj = Nothing
' Opens file "data.xml" and deserializes the object from it.
stream = File.Open("data.xml", FileMode.Open)
formatter = New SoapFormatter()
obj = CType(formatter.Deserialize(stream), TestSimpleObject)
stream.Close()
Console.WriteLine("")
Console.WriteLine("After deserialization the object contains: ")
obj.Print()
End Sub 'Main
End Class 'Test
' A test object that needs to be serialized.
<Serializable()> Public Class TestSimpleObject
Public member1 As Integer
Public member2 As String
Public member3 As String
Public member4 As Double
' A member that is not serialized.
<NonSerialized()> Public member5 As String
Public Sub New()
member1 = 11
member2 = "hello"
member3 = "hello"
member4 = 3.14159265
member5 = "hello world!"
End Sub 'New
Public Sub Print()
Console.WriteLine("member1 = '{0}'", member1)
Console.WriteLine("member2 = '{0}'", member2)
Console.WriteLine("member3 = '{0}'", member3)
Console.WriteLine("member4 = '{0}'", member4)
Console.WriteLine("member5 = '{0}'", member5)
End Sub 'Print
End Class 'TestSimpleObject
using System;
using System.IO;
using System.Runtime.Serialization;
using System.Runtime.Serialization.Formatters.Soap;
//using System.Runtime.Serialization.Formatters.Binary;
public class Test {
public static void Main() {
//Creates a new TestSimpleObject object.
TestSimpleObject obj = new TestSimpleObject();
Console.WriteLine("Before serialization the object contains: ");
obj.Print();
//Opens a file and serializes the object into it in binary format.
Stream stream = File.Open("data.xml", FileMode.Create);
SoapFormatter formatter = new SoapFormatter();
//BinaryFormatter formatter = new BinaryFormatter();
formatter.Serialize(stream, obj);
stream.Close();
//Empties obj.
obj = null;
//Opens file "data.xml" and deserializes the object from it.
stream = File.Open("data.xml", FileMode.Open);
formatter = new SoapFormatter();
//formatter = new BinaryFormatter();
obj = (TestSimpleObject)formatter.Deserialize(stream);
stream.Close();
Console.WriteLine("");
Console.WriteLine("After deserialization the object contains: ");
obj.Print();
}
}
// A test object that needs to be serialized.
[Serializable()]
public class TestSimpleObject {
public int member1;
public string member2;
public string member3;
public double member4;
// A field that is not serialized.
[NonSerialized()] public string member5;
public TestSimpleObject() {
member1 = 11;
member2 = "hello";
member3 = "hello";
member4 = 3.14159265;
member5 = "hello world!";
}
public void Print() {
Console.WriteLine("member1 = '{0}'", member1);
Console.WriteLine("member2 = '{0}'", member2);
Console.WriteLine("member3 = '{0}'", member3);
Console.WriteLine("member4 = '{0}'", member4);
Console.WriteLine("member5 = '{0}'", member5);
}
}
#using <system.dll>
#using <system.messaging.dll>
#using <System.Runtime.Serialization.Formatters.Soap.dll>
using namespace System;
using namespace System::IO;
using namespace System::Runtime::Serialization::Formatters::Soap;
// A test object that needs to be serialized.
[Serializable]
ref class TestSimpleObject
{
private:
int member1;
String^ member2;
String^ member3;
double member4;
public:
// A field that is not serialized.
[NonSerialized]
String^ member5;
TestSimpleObject()
{
member1 = 11;
member2 = "hello";
member3 = "hello";
member4 = 3.14159265;
member5 = "hello world!";
}
void Print()
{
Console::WriteLine( "member1 = ' {0}'", member1 );
Console::WriteLine( "member2 = ' {0}'", member2 );
Console::WriteLine( "member3 = ' {0}'", member3 );
Console::WriteLine( "member4 = ' {0}'", member4 );
Console::WriteLine( "member5 = ' {0}'", member5 );
}
};
int main()
{
//Creates a new TestSimpleObject object.
TestSimpleObject^ obj = gcnew TestSimpleObject;
Console::WriteLine( "Before serialization the Object* contains: " );
obj->Print();
//Opens a file and serializes the object into it in binary format.
Stream^ stream = File::Open( "data.xml", FileMode::Create );
SoapFormatter^ formatter = gcnew SoapFormatter;
//BinaryFormatter* formatter = new BinaryFormatter();
formatter->Serialize( stream, obj );
stream->Close();
//Empties obj.
obj = nullptr;
//Opens file S"data.xml" and deserializes the object from it.
stream = File::Open( "data.xml", FileMode::Open );
formatter = gcnew SoapFormatter;
//formatter = new BinaryFormatter();
obj = dynamic_cast<TestSimpleObject^>(formatter->Deserialize( stream ));
stream->Close();
Console::WriteLine( "" );
Console::WriteLine( "After deserialization the object contains: " );
obj->Print();
}
import System.*;
import System.IO.*;
import System.Runtime.Serialization.*;
import System.Runtime.Serialization.Formatters.Soap.*;
//import System.Runtime.Serialization.Formatters.Binary;
public class Test
{
public static void main(String[] args)
{
//Creates a new TestSimpleObject object.
TestSimpleObject obj = new TestSimpleObject();
Console.WriteLine("Before serialization the object contains: ");
obj.Print();
//Opens a file and serializes the object into it in binary format.
Stream stream = File.Open("data.xml", FileMode.Create);
SoapFormatter formatter = new SoapFormatter();
//BinaryFormatter formatter = new BinaryFormatter();
formatter.Serialize(stream, obj);
stream.Close();
//Empties obj.
obj = null;
//Opens file "data.xml" and deserializes the object from it.
stream = File.Open("data.xml", FileMode.Open);
formatter = new SoapFormatter();
//formatter = new BinaryFormatter();
obj = (TestSimpleObject)(formatter.Deserialize(stream));
stream.Close();
Console.WriteLine("");
Console.WriteLine("After deserialization the object contains: ");
obj.Print();
} //main
} //Test
// A test object that needs to be serialized.
/** @attribute Serializable()
*/
public class TestSimpleObject
{
public int member1;
public String member2;
public String member3;
public double member4;
// A field that is not serialized.
/** @attribute NonSerialized()
*/
public String member5;
public TestSimpleObject()
{
member1 = 11;
member2 = "hello";
member3 = "hello";
member4 = 3.14159265;
member5 = "hello world!";
} //TestSimpleObject
public void Print()
{
Console.WriteLine("member1 = '{0}'", (System.Int32)member1);
Console.WriteLine("member2 = '{0}'", member2);
Console.WriteLine("member3 = '{0}'", member3);
Console.WriteLine("member4 = '{0}'", (System.Double)member4);
Console.WriteLine("member5 = '{0}'", member5);
} //Print
} //TestSimpleObject
상속 계층 구조
System.Object
System.Attribute
System.NonSerializedAttribute
스레드로부터의 안전성
이 형식의 모든 public static(Visual Basic의 경우 Shared) 멤버는 스레드로부터 안전합니다. 인터페이스 멤버는 스레드로부터 안전하지 않습니다.
플랫폼
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework에서 모든 플래폼의 모든 버전을 지원하지는 않습니다. 지원되는 버전의 목록은 시스템 요구 사항을 참조하십시오.
버전 정보
.NET Framework
2.0, 1.1, 1.0에서 지원
.NET Compact Framework
2.0, 1.0에서 지원
참고 항목
참조
NonSerializedAttribute 멤버
System 네임스페이스
SerializableAttribute
Attribute 클래스
ISerializable