System.IO.Ports.xml 22 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398
  1. <?xml version="1.0"?>
  2. <doc>
  3. <assembly>
  4. <name>System.IO.Ports</name>
  5. </assembly>
  6. <members>
  7. <member name="T:System.IO.PathInternal">
  8. <summary>Contains internal path helpers that are shared between many projects.</summary>
  9. </member>
  10. <member name="M:System.IO.PathInternal.IsValidDriveChar(System.Char)">
  11. <summary>
  12. Returns true if the given character is a valid drive letter
  13. </summary>
  14. </member>
  15. <member name="M:System.IO.PathInternal.EnsureExtendedPrefixIfNeeded(System.String)">
  16. <summary>
  17. Adds the extended path prefix (\\?\) if not already a device path, IF the path is not relative,
  18. AND the path is more than 259 characters. (> MAX_PATH + null). This will also insert the extended
  19. prefix if the path ends with a period or a space. Trailing periods and spaces are normally eaten
  20. away from paths during normalization, but if we see such a path at this point it should be
  21. normalized and has retained the final characters. (Typically from one of the *Info classes)
  22. </summary>
  23. </member>
  24. <member name="M:System.IO.PathInternal.EnsureExtendedPrefix(System.String)">
  25. <summary>
  26. Adds the extended path prefix (\\?\) if not relative or already a device path.
  27. </summary>
  28. </member>
  29. <member name="M:System.IO.PathInternal.IsDevice(System.ReadOnlySpan{System.Char})">
  30. <summary>
  31. Returns true if the path uses any of the DOS device path syntaxes. ("\\.\", "\\?\", or "\??\")
  32. </summary>
  33. </member>
  34. <member name="M:System.IO.PathInternal.IsDeviceUNC(System.ReadOnlySpan{System.Char})">
  35. <summary>
  36. Returns true if the path is a device UNC (\\?\UNC\, \\.\UNC\)
  37. </summary>
  38. </member>
  39. <member name="M:System.IO.PathInternal.IsExtended(System.ReadOnlySpan{System.Char})">
  40. <summary>
  41. Returns true if the path uses the canonical form of extended syntax ("\\?\" or "\??\"). If the
  42. path matches exactly (cannot use alternate directory separators) Windows will skip normalization
  43. and path length checks.
  44. </summary>
  45. </member>
  46. <member name="M:System.IO.PathInternal.GetRootLength(System.ReadOnlySpan{System.Char})">
  47. <summary>
  48. Gets the length of the root of the path (drive, share, etc.).
  49. </summary>
  50. </member>
  51. <member name="M:System.IO.PathInternal.IsPartiallyQualified(System.ReadOnlySpan{System.Char})">
  52. <summary>
  53. Returns true if the path specified is relative to the current drive or working directory.
  54. Returns false if the path is fixed to a specific drive or UNC path. This method does no
  55. validation of the path (URIs will be returned as relative as a result).
  56. </summary>
  57. <remarks>
  58. Handles paths that use the alternate directory separator. It is a frequent mistake to
  59. assume that rooted paths (Path.IsPathRooted) are not relative. This isn't the case.
  60. "C:a" is drive relative- meaning that it will be resolved against the current directory
  61. for C: (rooted, but relative). "C:\a" is rooted and not relative (the current directory
  62. will not be used to modify the path).
  63. </remarks>
  64. </member>
  65. <member name="M:System.IO.PathInternal.IsDirectorySeparator(System.Char)">
  66. <summary>
  67. True if the given character is a directory separator.
  68. </summary>
  69. </member>
  70. <member name="M:System.IO.PathInternal.NormalizeDirectorySeparators(System.String)">
  71. <summary>
  72. Normalize separators in the given path. Converts forward slashes into back slashes and compresses slash runs, keeping initial 2 if present.
  73. Also trims initial whitespace in front of "rooted" paths (see PathStartSkip).
  74. This effectively replicates the behavior of the legacy NormalizePath when it was called with fullCheck=false and expandShortpaths=false.
  75. The current NormalizePath gets directory separator normalization from Win32's GetFullPathName(), which will resolve relative paths and as
  76. such can't be used here (and is overkill for our uses).
  77. Like the current NormalizePath this will not try and analyze periods/spaces within directory segments.
  78. </summary>
  79. <remarks>
  80. The only callers that used to use Path.Normalize(fullCheck=false) were Path.GetDirectoryName() and Path.GetPathRoot(). Both usages do
  81. not need trimming of trailing whitespace here.
  82. GetPathRoot() could technically skip normalizing separators after the second segment- consider as a future optimization.
  83. For legacy .NET Framework behavior with ExpandShortPaths:
  84. - It has no impact on GetPathRoot() so doesn't need consideration.
  85. - It could impact GetDirectoryName(), but only if the path isn't relative (C:\ or \\Server\Share).
  86. In the case of GetDirectoryName() the ExpandShortPaths behavior was undocumented and provided inconsistent results if the path was
  87. fixed/relative. For example: "C:\PROGRA~1\A.TXT" would return "C:\Program Files" while ".\PROGRA~1\A.TXT" would return ".\PROGRA~1". If you
  88. ultimately call GetFullPath() this doesn't matter, but if you don't or have any intermediate string handling could easily be tripped up by
  89. this undocumented behavior.
  90. We won't match this old behavior because:
  91. 1. It was undocumented
  92. 2. It was costly (extremely so if it actually contained '~')
  93. 3. Doesn't play nice with string logic
  94. 4. Isn't a cross-plat friendly concept/behavior
  95. </remarks>
  96. </member>
  97. <member name="M:System.IO.PathInternal.IsEffectivelyEmpty(System.ReadOnlySpan{System.Char})">
  98. <summary>
  99. Returns true if the path is effectively empty for the current OS.
  100. For unix, this is empty or null. For Windows, this is empty, null, or
  101. just spaces ((char)32).
  102. </summary>
  103. </member>
  104. <member name="T:System.IO.Win32Marshal">
  105. <summary>
  106. Provides static methods for converting from Win32 errors codes to exceptions, HRESULTS and error messages.
  107. </summary>
  108. </member>
  109. <member name="M:System.IO.Win32Marshal.GetExceptionForLastWin32Error(System.String)">
  110. <summary>
  111. Converts, resetting it, the last Win32 error into a corresponding <see cref="T:System.Exception"/> object, optionally
  112. including the specified path in the error message.
  113. </summary>
  114. </member>
  115. <member name="M:System.IO.Win32Marshal.GetExceptionForWin32Error(System.Int32,System.String)">
  116. <summary>
  117. Converts the specified Win32 error into a corresponding <see cref="T:System.Exception"/> object, optionally
  118. including the specified path in the error message.
  119. </summary>
  120. </member>
  121. <member name="M:System.IO.Win32Marshal.MakeHRFromErrorCode(System.Int32)">
  122. <summary>
  123. If not already an HRESULT, returns an HRESULT for the specified Win32 error code.
  124. </summary>
  125. </member>
  126. <member name="M:System.IO.Win32Marshal.TryMakeWin32ErrorCodeFromHR(System.Int32)">
  127. <summary>
  128. Returns a Win32 error code for the specified HRESULT if it came from FACILITY_WIN32
  129. If not, returns the HRESULT unchanged
  130. </summary>
  131. </member>
  132. <member name="M:System.Text.ValueStringBuilder.GetPinnableReference">
  133. <summary>
  134. Get a pinnable reference to the builder.
  135. Does not ensure there is a null char after <see cref="P:System.Text.ValueStringBuilder.Length"/>
  136. This overload is pattern matched in the C# 7.3+ compiler so you can omit
  137. the explicit method call, and write eg "fixed (char* c = builder)"
  138. </summary>
  139. </member>
  140. <member name="M:System.Text.ValueStringBuilder.GetPinnableReference(System.Boolean)">
  141. <summary>
  142. Get a pinnable reference to the builder.
  143. </summary>
  144. <param name="terminate">Ensures that the builder has a null char after <see cref="P:System.Text.ValueStringBuilder.Length"/></param>
  145. </member>
  146. <member name="P:System.Text.ValueStringBuilder.RawChars">
  147. <summary>Returns the underlying storage of the builder.</summary>
  148. </member>
  149. <member name="M:System.Text.ValueStringBuilder.AsSpan(System.Boolean)">
  150. <summary>
  151. Returns a span around the contents of the builder.
  152. </summary>
  153. <param name="terminate">Ensures that the builder has a null char after <see cref="P:System.Text.ValueStringBuilder.Length"/></param>
  154. </member>
  155. <member name="M:System.Text.ValueStringBuilder.Grow(System.Int32)">
  156. <summary>
  157. Resize the internal buffer either by doubling current buffer size or
  158. by adding <paramref name="additionalCapacityBeyondPos"/> to
  159. <see cref="F:System.Text.ValueStringBuilder._pos"/> whichever is greater.
  160. </summary>
  161. <param name="additionalCapacityBeyondPos">
  162. Number of chars requested beyond current position.
  163. </param>
  164. </member>
  165. <member name="P:System.SR.IO_EOF_ReadBeyondEOF">
  166. <summary>Unable to read beyond the end of the stream.</summary>
  167. </member>
  168. <member name="P:System.SR.BaseStream_Invalid_Not_Open">
  169. <summary>The BaseStream is only available when the port is open.</summary>
  170. </member>
  171. <member name="P:System.SR.PortNameEmpty_String">
  172. <summary>The PortName cannot be empty.</summary>
  173. </member>
  174. <member name="P:System.SR.Port_not_open">
  175. <summary>The port is closed.</summary>
  176. </member>
  177. <member name="P:System.SR.Port_already_open">
  178. <summary>The port is already open.</summary>
  179. </member>
  180. <member name="P:System.SR.Cant_be_set_when_open">
  181. <summary>'{0}' cannot be set while the port is open.</summary>
  182. </member>
  183. <member name="P:System.SR.Max_Baud">
  184. <summary>The maximum baud rate for the device is {0}.</summary>
  185. </member>
  186. <member name="P:System.SR.In_Break_State">
  187. <summary>The port is in the break state and cannot be written to.</summary>
  188. </member>
  189. <member name="P:System.SR.Write_timed_out">
  190. <summary>The write timed out.</summary>
  191. </member>
  192. <member name="P:System.SR.CantSetRtsWithHandshaking">
  193. <summary>RtsEnable cannot be accessed if Handshake is set to RequestToSend or RequestToSendXOnXOff.</summary>
  194. </member>
  195. <member name="P:System.SR.NotSupportedEncoding">
  196. <summary>SerialPort does not support encoding '{0}'. The supported encodings include ASCIIEncoding, UTF8Encoding, UnicodeEncoding, UTF32Encoding, and most single or double byte code pages. For a complete list please see the documentation.</summary>
  197. </member>
  198. <member name="P:System.SR.Arg_InvalidSerialPort">
  199. <summary>The given port name ({0}) does not resolve to a valid serial port.</summary>
  200. </member>
  201. <member name="P:System.SR.Arg_InvalidSerialPortExtended">
  202. <summary>The given port name is invalid. It may be a valid port, but not a serial port.</summary>
  203. </member>
  204. <member name="P:System.SR.Argument_InvalidOffLen">
  205. <summary>Offset and length were out of bounds for the array or count is greater than the number of elements from index to the end of the source collection.</summary>
  206. </member>
  207. <member name="P:System.SR.ArgumentOutOfRange_Bounds_Lower_Upper">
  208. <summary>Argument must be between {0} and {1}.</summary>
  209. </member>
  210. <member name="P:System.SR.ArgumentOutOfRange_Enum">
  211. <summary>Enum value was out of legal range.</summary>
  212. </member>
  213. <member name="P:System.SR.ArgumentOutOfRange_NeedNonNegNumRequired">
  214. <summary>Non-negative number required.</summary>
  215. </member>
  216. <member name="P:System.SR.ArgumentOutOfRange_NeedPosNum">
  217. <summary>Positive number required.</summary>
  218. </member>
  219. <member name="P:System.SR.ArgumentOutOfRange_Timeout">
  220. <summary>The timeout must be greater than or equal to -1.</summary>
  221. </member>
  222. <member name="P:System.SR.ArgumentOutOfRange_WriteTimeout">
  223. <summary>The timeout must be either a positive number or -1.</summary>
  224. </member>
  225. <member name="P:System.SR.IndexOutOfRange_IORaceCondition">
  226. <summary>Probable I/O race condition detected while copying memory. The I/O package is not thread safe by default. In multithreaded applications, a stream must be accessed in a thread-safe way, such as a thread-safe wrapper returned by TextReader's or TextWriter's ...</summary>
  227. </member>
  228. <member name="P:System.SR.IO_OperationAborted">
  229. <summary>The I/O operation has been aborted because of either a thread exit or an application request.</summary>
  230. </member>
  231. <member name="P:System.SR.NotSupported_UnseekableStream">
  232. <summary>Stream does not support seeking.</summary>
  233. </member>
  234. <member name="P:System.SR.ObjectDisposed_StreamClosed">
  235. <summary>Cannot access a closed stream.</summary>
  236. </member>
  237. <member name="P:System.SR.InvalidNullEmptyArgument">
  238. <summary>Argument {0} cannot be null or zero-length.</summary>
  239. </member>
  240. <member name="P:System.SR.Arg_WrongAsyncResult">
  241. <summary>IAsyncResult object did not come from the corresponding async method on this type.</summary>
  242. </member>
  243. <member name="P:System.SR.InvalidOperation_EndReadCalledMultiple">
  244. <summary>EndRead can only be called once for each asynchronous operation.</summary>
  245. </member>
  246. <member name="P:System.SR.InvalidOperation_EndWriteCalledMultiple">
  247. <summary>EndWrite can only be called once for each asynchronous operation.</summary>
  248. </member>
  249. <member name="P:System.SR.UnauthorizedAccess_IODenied_Port">
  250. <summary>Access to the port '{0}' is denied.</summary>
  251. </member>
  252. <member name="P:System.SR.PlatformNotSupported_IOPorts">
  253. <summary>System.IO.Ports is currently only supported on Windows.</summary>
  254. </member>
  255. <member name="P:System.SR.PlatformNotSupported_SerialPort_GetPortNames">
  256. <summary>Enumeration of serial port names is not supported on the current platform.</summary>
  257. </member>
  258. <member name="P:System.SR.IO_PathTooLong">
  259. <summary>The specified file name or path is too long, or a component of the specified path is too long.</summary>
  260. </member>
  261. <member name="P:System.SR.IO_PathNotFound_NoPathName">
  262. <summary>Could not find a part of the path.</summary>
  263. </member>
  264. <member name="P:System.SR.IO_PathNotFound_Path">
  265. <summary>Could not find a part of the path '{0}'.</summary>
  266. </member>
  267. <member name="P:System.SR.IO_FileNotFound">
  268. <summary>Unable to find the specified file.</summary>
  269. </member>
  270. <member name="P:System.SR.IO_FileNotFound_FileName">
  271. <summary>Could not find file '{0}'.</summary>
  272. </member>
  273. <member name="P:System.SR.UnauthorizedAccess_IODenied_NoPathName">
  274. <summary>Access to the path is denied.</summary>
  275. </member>
  276. <member name="P:System.SR.UnauthorizedAccess_IODenied_Path">
  277. <summary>Access to the path '{0}' is denied.</summary>
  278. </member>
  279. <member name="P:System.SR.IO_PathTooLong_Path">
  280. <summary>The path '{0}' is too long, or a component of the specified path is too long.</summary>
  281. </member>
  282. <member name="P:System.SR.IO_SharingViolation_File">
  283. <summary>The process cannot access the file '{0}' because it is being used by another process.</summary>
  284. </member>
  285. <member name="P:System.SR.IO_SharingViolation_NoFileName">
  286. <summary>The process cannot access the file because it is being used by another process.</summary>
  287. </member>
  288. <member name="P:System.SR.ArgumentOutOfRange_FileLengthTooBig">
  289. <summary>Specified file length was too large for the file system.</summary>
  290. </member>
  291. <member name="P:System.SR.IO_FileExists_Name">
  292. <summary>The file '{0}' already exists.</summary>
  293. </member>
  294. <member name="P:System.SR.IO_AlreadyExists_Name">
  295. <summary>Cannot create '{0}' because a file or directory with the same name already exists.</summary>
  296. </member>
  297. <member name="T:System.Runtime.InteropServices.LibraryImportAttribute">
  298. <summary>
  299. Attribute used to indicate a source generator should create a function for marshalling
  300. arguments instead of relying on the runtime to generate an equivalent marshalling function at run-time.
  301. </summary>
  302. <remarks>
  303. This attribute is meaningless if the source generator associated with it is not enabled.
  304. The current built-in source generator only supports C# and only supplies an implementation when
  305. applied to static, partial, non-generic methods.
  306. </remarks>
  307. </member>
  308. <member name="M:System.Runtime.InteropServices.LibraryImportAttribute.#ctor(System.String)">
  309. <summary>
  310. Initializes a new instance of the <see cref="T:System.Runtime.InteropServices.LibraryImportAttribute"/>.
  311. </summary>
  312. <param name="libraryName">Name of the library containing the import.</param>
  313. </member>
  314. <member name="P:System.Runtime.InteropServices.LibraryImportAttribute.LibraryName">
  315. <summary>
  316. Gets the name of the library containing the import.
  317. </summary>
  318. </member>
  319. <member name="P:System.Runtime.InteropServices.LibraryImportAttribute.EntryPoint">
  320. <summary>
  321. Gets or sets the name of the entry point to be called.
  322. </summary>
  323. </member>
  324. <member name="P:System.Runtime.InteropServices.LibraryImportAttribute.StringMarshalling">
  325. <summary>
  326. Gets or sets how to marshal string arguments to the method.
  327. </summary>
  328. <remarks>
  329. If this field is set to a value other than <see cref="F:System.Runtime.InteropServices.StringMarshalling.Custom" />,
  330. <see cref="P:System.Runtime.InteropServices.LibraryImportAttribute.StringMarshallingCustomType" /> must not be specified.
  331. </remarks>
  332. </member>
  333. <member name="P:System.Runtime.InteropServices.LibraryImportAttribute.StringMarshallingCustomType">
  334. <summary>
  335. Gets or sets the <see cref="T:System.Type"/> used to control how string arguments to the method are marshalled.
  336. </summary>
  337. <remarks>
  338. If this field is specified, <see cref="P:System.Runtime.InteropServices.LibraryImportAttribute.StringMarshalling" /> must not be specified
  339. or must be set to <see cref="F:System.Runtime.InteropServices.StringMarshalling.Custom" />.
  340. </remarks>
  341. </member>
  342. <member name="P:System.Runtime.InteropServices.LibraryImportAttribute.SetLastError">
  343. <summary>
  344. Gets or sets whether the callee sets an error (SetLastError on Windows or errno
  345. on other platforms) before returning from the attributed method.
  346. </summary>
  347. </member>
  348. <member name="T:System.Runtime.InteropServices.StringMarshalling">
  349. <summary>
  350. Specifies how strings should be marshalled for generated p/invokes
  351. </summary>
  352. </member>
  353. <member name="F:System.Runtime.InteropServices.StringMarshalling.Custom">
  354. <summary>
  355. Indicates the user is suppling a specific marshaller in <see cref="P:System.Runtime.InteropServices.LibraryImportAttribute.StringMarshallingCustomType"/>.
  356. </summary>
  357. </member>
  358. <member name="F:System.Runtime.InteropServices.StringMarshalling.Utf8">
  359. <summary>
  360. Use the platform-provided UTF-8 marshaller.
  361. </summary>
  362. </member>
  363. <member name="F:System.Runtime.InteropServices.StringMarshalling.Utf16">
  364. <summary>
  365. Use the platform-provided UTF-16 marshaller.
  366. </summary>
  367. </member>
  368. <member name="M:Interop.Kernel32.GetMessage(System.Int32)">
  369. <summary>
  370. Returns a string message for the specified Win32 error code.
  371. </summary>
  372. </member>
  373. <member name="M:Interop.Kernel32.CreateFilePrivate(System.String,System.Int32,System.IO.FileShare,Interop.Kernel32.SECURITY_ATTRIBUTES*,System.IO.FileMode,System.Int32,System.IntPtr)">
  374. <summary>
  375. WARNING: This method does not implicitly handle long paths. Use CreateFile.
  376. </summary>
  377. </member>
  378. <member name="T:Interop.BOOL">
  379. <summary>
  380. Blittable version of Windows BOOL type. It is convenient in situations where
  381. manual marshalling is required, or to avoid overhead of regular bool marshalling.
  382. </summary>
  383. <remarks>
  384. Some Windows APIs return arbitrary integer values although the return type is defined
  385. as BOOL. It is best to never compare BOOL to TRUE. Always use bResult != BOOL.FALSE
  386. or bResult == BOOL.FALSE .
  387. </remarks>
  388. </member>
  389. </members>
  390. </doc>