NSInputStream 类

定义

命名空间:

Foundation

程序集:

Xamarin.iOS.dll

只读输入 NSStream。

[Foundation.Register("NSInputStream", true)]
public class NSInputStream : Foundation.NSStream

type NSInputStream = class
    inherit NSStream

继承

Object

NSObject

NSStream

NSInputStream

属性

RegisterAttribute

注解

对 NSInputStream 进行子类化。

NSInputStream 是 NSStream 的具体子类，可用于授予对流数据的只读访问权限。 在大多数情况下，这已足够，但如果希望对数据进行更多控制，则可以将 NSInputStream 子类化。 如果为 NSInputStream 子类，则必须提供以下方法的实现：

• M：Foundation.NSInputStream.Read (IntPtr，uint) ：在此方法中，必须将字节写入提供的缓冲区。 可以使用 M：System.Runtime.InteropServices.Marshal.Copy (byte[]，int，IntPtr，intPtr，int) 从字节数组写入提供的缓冲区。 返回实际写入的字节数。
• GetBuffer(IntPtr, nuint)：返回指向可以读取字节的缓冲区的指针。 可以从此方法返回 false，并且只需实现 M：Foundation.NSInputStream.Read (IntPtr，uint) 。
• HasBytesAvailable()：使用此方法指示流何时具有要读取的数据。

提供免费桥接 NSInputStream 子类。

提供免费桥接 NSInputStream 子类所需的方法被视为专用 API，可能会导致 Apple 拒绝来自App Store的应用。

简单的 NSInputStream 子类不适用于采用 NSInputStream 的所有 API。 for 实例就是这种情况 NSMutableUrlRequest ，它实际上需要 CFReadStream 对象的实例。 为此，NSInputStream 子类需要免费桥接到 CFReadStream。 这是通过重写以下方法完成的：

• SetCFClientFlags(CFStreamEventType, IntPtr, IntPtr)：调用此方法以注册客户端以通知流中的事件。 必须使用传入的确切参数调用基实现。
• M：Foundation.NSInputStream.ScheduleInCFRunLoop (IntPtr，string) ：根据提供数据所执行的操作，在调用此方法时需要在运行循环中计划。 不应为此方法调用基实现。
• M：Foundation.NSInputStream.UnscheduleInCFRunLoop (IntPtr，string) ：当需要从运行循环取消计划时，将调用它。 不应为此方法调用基实现。

还必须调用 M：Foundation.NSInputStream.Notify ( (valuetype CoreFoundation.CFStreamEventType) ，以便在有可用数据 (或有任何其他相关事件) 时通知客户端，否则不会从中读取输入流。

构造函数

NSInputStream()	不带参数初始化此类的新实例的默认构造函数。
NSInputStream(IntPtr)	创建非托管对象的托管表示形式时使用的构造函数;由运行时调用。
NSInputStream(NSData)	只读输入 NSStream。
NSInputStream(NSObjectFlag)	在派生类上调用 的构造函数，以跳过初始化并仅分配 对象。
NSInputStream(NSUrl)	只读输入 NSStream。
NSInputStream(String)	只读输入 NSStream。

属性

Class	只读输入 NSStream。 (继承自 NSObject)
ClassHandle	此类的句柄。
DataWrittenToMemoryStream	包含到目前为止已写入的流数据的 NSData。 (继承自 NSStream)
DebugDescription	此对象的开发人员有意义的说明。 (继承自 NSObject)
Delegate	充当类委托的 Foundation.INSStreamDelegate 模型类的实例。 (继承自 NSStream)
Description	对象的说明，即 ToString 的 Objective-C 版本。 (继承自 NSObject)
Error	如果有任何) ， (当前流错误。 (继承自 NSStream)
FileCurrentOffset	流的绝对偏移量。 (继承自 NSStream)
Handle	处理指向非托管对象表示形式的 (指针) 。 (继承自 NSObject)
IsDirectBinding	只读输入 NSStream。 (继承自 NSObject)
IsProxy	只读输入 NSStream。 (继承自 NSObject)
Item[NSString]	在 NSStream 上设置配置密钥。 (继承自 NSStream)
RetainCount	返回对象的当前 Objective-C 保留计数。 (继承自 NSObject)
Self	只读输入 NSStream。 (继承自 NSObject)
ServiceType	流提供的服务类型。 (继承自 NSStream)
SocketSecurityLevel	控制用于连接的安全协议， (无、SSL、TLS、协商) 。 (继承自 NSStream)
SocksOptions	使用 SOCKS 代理服务器的设置。 (继承自 NSStream)
Status	只读输入 NSStream。 (继承自 NSStream)
Superclass	只读输入 NSStream。 (继承自 NSObject)
SuperHandle	用于表示此 NSObject 基类中方法的句柄。 (继承自 NSObject)
WeakDelegate	可以响应此类型的委托协议的对象 (继承自 NSStream)
Zone	只读输入 NSStream。 (继承自 NSObject)

方法

AddObserver(NSObject, NSString, NSKeyValueObservingOptions, IntPtr)	使用 NSString keyPath) 注册一个对象，以便在外部 (观察到该对象。   观察到的更改将调度到观察者的 对象 ObserveValue(NSString, NSObject, NSDictionary, IntPtr) 方法。 (继承自 NSObject)
AddObserver(NSObject, String, NSKeyValueObservingOptions, IntPtr)	使用字符串 keyPath) 注册一个对象，以便在外部 (观察到该对象。   观察到的更改将调度到观察者的 对象 ObserveValue(NSString, NSObject, NSDictionary, IntPtr) 方法。 (继承自 NSObject)
AddObserver(NSString, NSKeyValueObservingOptions, Action<NSObservedChange>)	注册一个对象，以便使用任意方法在外部观察。 (继承自 NSObject)
AddObserver(String, NSKeyValueObservingOptions, Action<NSObservedChange>)	注册一个对象，以便使用任意方法在外部观察。 (继承自 NSObject)
AwakeFromNib()	从 nib 文件加载对象后调用。 替代器必须调用 base。AwakeFromNib () 。 (继承自 NSObject)
BeginInvokeOnMainThread(Action)	只读输入 NSStream。 (继承自 NSObject)
BeginInvokeOnMainThread(Selector, NSObject)	在主 UI 线程上异步调用指定的代码。 (继承自 NSObject)
Bind(NSString, NSObject, String, NSDictionary)	只读输入 NSStream。 (继承自 NSObject)
Bind(String, NSObject, String, NSDictionary)	只读输入 NSStream。 (继承自 NSObject)
BindingInfo(String)	只读输入 NSStream。 (继承自 NSObject)
BindingOptionDescriptions(String)	只读输入 NSStream。 (继承自 NSObject)
BindingValueClass(String)	只读输入 NSStream。 (继承自 NSObject)
Close()	关闭流并释放与其关联的资源。 (继承自 NSStream)
CommitEditing()	只读输入 NSStream。 (继承自 NSObject)
CommitEditing(NSObject, Selector, IntPtr)	只读输入 NSStream。 (继承自 NSObject)
ConformsToProtocol(IntPtr)	调用以确定此对象是否实现指定的协议。 (继承自 NSObject)
Copy()	执行基础 Objective-C 对象的副本。 (继承自 NSObject)
DangerousAutorelease()	只读输入 NSStream。 (继承自 NSObject)
DangerousRelease()	只读输入 NSStream。 (继承自 NSObject)
DangerousRetain()	只读输入 NSStream。 (继承自 NSObject)
DidChange(NSKeyValueChange, NSIndexSet, NSString)	指示对多关系的索引发生了更改。 (继承自 NSObject)
DidChange(NSString, NSKeyValueSetMutationKind, NSSet)	只读输入 NSStream。 (继承自 NSObject)
DidChangeValue(String)	指示对指定的键进行了更改。 (继承自 NSObject)
Dispose()	释放 NSObject 对象使用的资源。 (继承自 NSObject)
Dispose(Boolean)	释放 NSInputStream 对象使用的资源。
DoesNotRecognizeSelector(Selector)	指示此对象无法识别指定的选择器。 (继承自 NSObject)
Equals(NSObject)	只读输入 NSStream。 (继承自 NSObject)
Equals(Object)	只读输入 NSStream。 (继承自 NSObject)
ExposedBindings()	只读输入 NSStream。 (继承自 NSObject)
FromData(NSData)	只读输入 NSStream。
FromFile(String)	只读输入 NSStream。
FromUrl(NSUrl)	只读输入 NSStream。
GetBindingInfo(NSString)	只读输入 NSStream。 (继承自 NSObject)
GetBindingOptionDescriptions(NSString)	只读输入 NSStream。 (继承自 NSObject)
GetBindingValueClass(NSString)	只读输入 NSStream。 (继承自 NSObject)
GetBuffer(IntPtr, nuint)	此方法可以返回指向调用方可以从中读取数据的缓冲区的指针。
GetDictionaryOfValuesFromKeys(NSString[])	检索指定键的值。 (继承自 NSObject)
GetHashCode()	为当前实例生成哈希代码。 (继承自 NSObject)
GetMethodForSelector(Selector)	只读输入 NSStream。 (继承自 NSObject)
GetNativeField(String)	已过时. 只读输入 NSStream。 (继承自 NSObject)
GetNativeHash()	只读输入 NSStream。 (继承自 NSObject)
GetProperty(NSString)	只读输入 NSStream。 (继承自 NSStream)
HasBytesAvailable()	返回一个布尔值，该值指示流是否有可供读取的字节。
Init()	只读输入 NSStream。 (继承自 NSObject)
InitializeHandle(IntPtr)	只读输入 NSStream。 (继承自 NSObject)
InitializeHandle(IntPtr, String)	只读输入 NSStream。 (继承自 NSObject)
Invoke(Action, Double)	只读输入 NSStream。 (继承自 NSObject)
Invoke(Action, TimeSpan)	只读输入 NSStream。 (继承自 NSObject)
InvokeOnMainThread(Action)	只读输入 NSStream。 (继承自 NSObject)
InvokeOnMainThread(Selector, NSObject)	同步调用主 UI 线程上的指定代码。 (继承自 NSObject)
IsEqual(NSObject)	只读输入 NSStream。 (继承自 NSObject)
IsKindOfClass(Class)	只读输入 NSStream。 (继承自 NSObject)
IsMemberOfClass(Class)	只读输入 NSStream。 (继承自 NSObject)
MarkDirty()	将常规对等对象 (IsDirectBinding 为 true) 提升为 toggleref 对象。 (继承自 NSObject)
MutableCopy()	创建指定 NSObject 的可变副本。 (继承自 NSObject)
Notify(CFStreamEventType)	通知使用者流中的事件。
ObjectDidEndEditing(NSObject)	只读输入 NSStream。 (继承自 NSObject)
ObserveValue(NSString, NSObject, NSDictionary, IntPtr)	指示相对于此对象的指定 keyPath 处的值已更改。 (继承自 NSObject)
Open()	只读输入 NSStream。 (继承自 NSStream)
PerformSelector(Selector)	只读输入 NSStream。 (继承自 NSObject)
PerformSelector(Selector, NSObject)	只读输入 NSStream。 (继承自 NSObject)
PerformSelector(Selector, NSObject, Double)	在当前实例上调用选择器，如果 obj 不为 null，则将其作为其单个参数传递。 (继承自 NSObject)
PerformSelector(Selector, NSObject, Double, NSString[])	只读输入 NSStream。 (继承自 NSObject)
PerformSelector(Selector, NSObject, NSObject)	只读输入 NSStream。 (继承自 NSObject)
PerformSelector(Selector, NSThread, NSObject, Boolean)	只读输入 NSStream。 (继承自 NSObject)
PerformSelector(Selector, NSThread, NSObject, Boolean, NSString[])	只读输入 NSStream。 (继承自 NSObject)
PrepareForInterfaceBuilder()	只读输入 NSStream。 (继承自 NSObject)
Read(Byte[], Int32, nuint)	只读输入 NSStream。
Read(Byte[], nuint)	将数据从流读取到提供的缓冲区中。
Read(IntPtr, nuint)	将数据从流读取到提供的缓冲区中。 不应直接调用此方法，应改为调用 M：Foundation.NSInputStream.Read (byte[]，uint) 。 此方法适用于要实现的 NSInputStream 子类。
RemoveObserver(NSObject, NSString)	阻止指定观察程序接收指定 keyPath 的更改值的进一步通知。 (继承自 NSObject)
RemoveObserver(NSObject, NSString, IntPtr)	停止指定的观察程序接收指定 keyPath 和上下文的更改值的进一步通知。 (继承自 NSObject)
RemoveObserver(NSObject, String)	阻止指定观察程序接收指定 keyPath 的更改值的进一步通知。 (继承自 NSObject)
RemoveObserver(NSObject, String, IntPtr)	停止指定的观察程序接收指定 keyPath 和上下文的更改值的进一步通知。 (继承自 NSObject)
RespondsToSelector(Selector)	此对象是否识别指定的选择器。 (继承自 NSObject)
Schedule(NSRunLoop, NSRunLoopMode)	只读输入 NSStream。 (继承自 NSStream)
Schedule(NSRunLoop, String)	计划流在具有指定模式的指定运行循环上运行。 (继承自 NSStream)
SetCFClientFlags(CFStreamEventType, IntPtr, IntPtr)	为流添加客户端。 此方法不应由托管代码调用，它将由流的使用者调用。 重写时，请确保调用基实现。
SetNativeField(String, NSObject)	已过时. 只读输入 NSStream。 (继承自 NSObject)
SetNilValueForKey(NSString)	将指定键的值设置为 null。 (继承自 NSObject)
SetProperty(NSObject, NSString)	只读输入 NSStream。 (继承自 NSStream)
SetValueForKey(NSObject, NSString)	将键指定的属性的值设置为指定的值。 (继承自 NSObject)
SetValueForKeyPath(IntPtr, NSString)	创建非托管对象的托管表示形式时使用的构造函数;由运行时调用。 (继承自 NSObject)
SetValueForKeyPath(NSObject, NSString)	设置可以使用键路径访问的属性的值。 (继承自 NSObject)
SetValueForUndefinedKey(NSObject, NSString)	指示尝试将值写入未定义的键。 如果未重写，则引发 NSUndefinedKeyException。 (继承自 NSObject)
SetValuesForKeysWithDictionary(NSDictionary)	将此 NSObject 的值设置为指定字典中的值。 (继承自 NSObject)
ToString()	返回当前实例的值的字符串表示形式。 (继承自 NSObject)
Unbind(NSString)	只读输入 NSStream。 (继承自 NSObject)
Unbind(String)	只读输入 NSStream。 (继承自 NSObject)
Unschedule(NSRunLoop, NSRunLoopMode)	只读输入 NSStream。 (继承自 NSStream)
Unschedule(NSRunLoop, String)	只读输入 NSStream。 (继承自 NSStream)
ValueForKey(NSString)	返回与指定键关联的属性的值。 (继承自 NSObject)
ValueForKeyPath(NSString)	返回可以使用键路径访问的属性的值。 (继承自 NSObject)
ValueForUndefinedKey(NSString)	指示尝试读取未定义键的值。 如果未重写，则引发 NSUndefinedKeyException。 (继承自 NSObject)
WillChange(NSKeyValueChange, NSIndexSet, NSString)	指示指定键中指定索引的值即将更改。 (继承自 NSObject)
WillChange(NSString, NSKeyValueSetMutationKind, NSSet)	只读输入 NSStream。 (继承自 NSObject)
WillChangeValue(String)	指示指定键的值即将更改。 (继承自 NSObject)

事件

OnEvent

只读输入 NSStream。 (继承自 NSStream)

扩展方法

GetDebugDescription(INSObjectProtocol)	只读输入 NSStream。
GetAccessibilityCustomRotors(NSObject)	获取适用于 this 对象的 对象的数组UIAccessibilityCustomRotor。
SetAccessibilityCustomRotors(NSObject, UIAccessibilityCustomRotor[])	设置适用于 this 对象的 对象数组UIAccessibilityCustomRotor。

另请参阅

• Apple 文档 NSInputStream