Swashbuckle.AspNetCore.SwaggerGen.xml 20 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281
  1. <?xml version="1.0"?>
  2. <doc>
  3. <assembly>
  4. <name>Swashbuckle.AspNetCore.SwaggerGen</name>
  5. </assembly>
  6. <members>
  7. <member name="T:Microsoft.Extensions.ApiDescriptions.IDocumentProvider">
  8. <summary>
  9. This service will be looked up by name from the service collection when using
  10. the <c>dotnet-getdocument</c> tool from the Microsoft.Extensions.ApiDescription.Server package.
  11. </summary>
  12. </member>
  13. <member name="M:Microsoft.Extensions.DependencyInjection.SwaggerGenOptionsExtensions.SwaggerDoc(Swashbuckle.AspNetCore.SwaggerGen.SwaggerGenOptions,System.String,Microsoft.OpenApi.Models.OpenApiInfo)">
  14. <summary>
  15. Define one or more documents to be created by the Swagger generator
  16. </summary>
  17. <param name="swaggerGenOptions"></param>
  18. <param name="name">A URI-friendly name that uniquely identifies the document</param>
  19. <param name="info">Global metadata to be included in the Swagger output</param>
  20. </member>
  21. <member name="M:Microsoft.Extensions.DependencyInjection.SwaggerGenOptionsExtensions.DocInclusionPredicate(Swashbuckle.AspNetCore.SwaggerGen.SwaggerGenOptions,System.Func{System.String,Microsoft.AspNetCore.Mvc.ApiExplorer.ApiDescription,System.Boolean})">
  22. <summary>
  23. Provide a custom strategy for selecting actions.
  24. </summary>
  25. <param name="swaggerGenOptions"></param>
  26. <param name="predicate">
  27. A lambda that returns true/false based on document name and ApiDescription
  28. </param>
  29. </member>
  30. <member name="M:Microsoft.Extensions.DependencyInjection.SwaggerGenOptionsExtensions.IgnoreObsoleteActions(Swashbuckle.AspNetCore.SwaggerGen.SwaggerGenOptions)">
  31. <summary>
  32. Ignore any actions that are decorated with the ObsoleteAttribute
  33. </summary>
  34. </member>
  35. <member name="M:Microsoft.Extensions.DependencyInjection.SwaggerGenOptionsExtensions.ResolveConflictingActions(Swashbuckle.AspNetCore.SwaggerGen.SwaggerGenOptions,System.Func{System.Collections.Generic.IEnumerable{Microsoft.AspNetCore.Mvc.ApiExplorer.ApiDescription},Microsoft.AspNetCore.Mvc.ApiExplorer.ApiDescription})">
  36. <summary>
  37. Merge actions that have conflicting HTTP methods and paths (must be unique for Swagger 2.0)
  38. </summary>
  39. <param name="swaggerGenOptions"></param>
  40. <param name="resolver"></param>
  41. </member>
  42. <member name="M:Microsoft.Extensions.DependencyInjection.SwaggerGenOptionsExtensions.CustomOperationIds(Swashbuckle.AspNetCore.SwaggerGen.SwaggerGenOptions,System.Func{Microsoft.AspNetCore.Mvc.ApiExplorer.ApiDescription,System.String})">
  43. <summary>
  44. Provide a custom strategy for assigning "operationId" to operations
  45. </summary>
  46. </member>
  47. <member name="M:Microsoft.Extensions.DependencyInjection.SwaggerGenOptionsExtensions.TagActionsBy(Swashbuckle.AspNetCore.SwaggerGen.SwaggerGenOptions,System.Func{Microsoft.AspNetCore.Mvc.ApiExplorer.ApiDescription,System.String})">
  48. <summary>
  49. Provide a custom strategy for assigning a default "tag" to operations
  50. </summary>
  51. <param name="swaggerGenOptions"></param>
  52. <param name="tagSelector"></param>
  53. </member>
  54. <member name="M:Microsoft.Extensions.DependencyInjection.SwaggerGenOptionsExtensions.TagActionsBy(Swashbuckle.AspNetCore.SwaggerGen.SwaggerGenOptions,System.Func{Microsoft.AspNetCore.Mvc.ApiExplorer.ApiDescription,System.Collections.Generic.IList{System.String}})">
  55. <summary>
  56. Provide a custom strategy for assigning "tags" to actions
  57. </summary>
  58. <param name="swaggerGenOptions"></param>
  59. <param name="tagsSelector"></param>
  60. </member>
  61. <member name="M:Microsoft.Extensions.DependencyInjection.SwaggerGenOptionsExtensions.OrderActionsBy(Swashbuckle.AspNetCore.SwaggerGen.SwaggerGenOptions,System.Func{Microsoft.AspNetCore.Mvc.ApiExplorer.ApiDescription,System.String})">
  62. <summary>
  63. Provide a custom strategy for sorting actions before they're transformed into the Swagger format
  64. </summary>
  65. <param name="swaggerGenOptions"></param>
  66. <param name="sortKeySelector"></param>
  67. </member>
  68. <member name="M:Microsoft.Extensions.DependencyInjection.SwaggerGenOptionsExtensions.SortSchemasWith(Swashbuckle.AspNetCore.SwaggerGen.SwaggerGenOptions,System.Collections.Generic.IComparer{System.String})">
  69. <summary>
  70. Provide a custom comprarer to sort schemas with
  71. </summary>
  72. <param name="swaggerGenOptions"></param>
  73. <param name="schemaComparer"></param>
  74. </member>
  75. <member name="M:Microsoft.Extensions.DependencyInjection.SwaggerGenOptionsExtensions.DescribeAllParametersInCamelCase(Swashbuckle.AspNetCore.SwaggerGen.SwaggerGenOptions)">
  76. <summary>
  77. Describe all parameters, regardless of how they appear in code, in camelCase
  78. </summary>
  79. </member>
  80. <member name="M:Microsoft.Extensions.DependencyInjection.SwaggerGenOptionsExtensions.AddServer(Swashbuckle.AspNetCore.SwaggerGen.SwaggerGenOptions,Microsoft.OpenApi.Models.OpenApiServer)">
  81. <summary>
  82. Provide specific server information to include in the generated Swagger document
  83. </summary>
  84. <param name="swaggerGenOptions"></param>
  85. <param name="server">A description of the server</param>
  86. </member>
  87. <member name="M:Microsoft.Extensions.DependencyInjection.SwaggerGenOptionsExtensions.AddSecurityDefinition(Swashbuckle.AspNetCore.SwaggerGen.SwaggerGenOptions,System.String,Microsoft.OpenApi.Models.OpenApiSecurityScheme)">
  88. <summary>
  89. Add one or more "securityDefinitions", describing how your API is protected, to the generated Swagger
  90. </summary>
  91. <param name="swaggerGenOptions"></param>
  92. <param name="name">A unique name for the scheme, as per the Swagger spec.</param>
  93. <param name="securityScheme">
  94. A description of the scheme - can be an instance of BasicAuthScheme, ApiKeyScheme or OAuth2Scheme
  95. </param>
  96. </member>
  97. <member name="M:Microsoft.Extensions.DependencyInjection.SwaggerGenOptionsExtensions.AddSecurityRequirement(Swashbuckle.AspNetCore.SwaggerGen.SwaggerGenOptions,Microsoft.OpenApi.Models.OpenApiSecurityRequirement)">
  98. <summary>
  99. Adds a global security requirement
  100. </summary>
  101. <param name="swaggerGenOptions"></param>
  102. <param name="securityRequirement">
  103. A dictionary of required schemes (logical AND). Keys must correspond to schemes defined through AddSecurityDefinition
  104. If the scheme is of type "oauth2", then the value is a list of scopes, otherwise it MUST be an empty array
  105. </param>
  106. </member>
  107. <member name="M:Microsoft.Extensions.DependencyInjection.SwaggerGenOptionsExtensions.MapType(Swashbuckle.AspNetCore.SwaggerGen.SwaggerGenOptions,System.Type,System.Func{Microsoft.OpenApi.Models.OpenApiSchema})">
  108. <summary>
  109. Provide a custom mapping, for a given type, to the Swagger-flavored JSONSchema
  110. </summary>
  111. <param name="swaggerGenOptions"></param>
  112. <param name="type">System type</param>
  113. <param name="schemaFactory">A factory method that generates Schema's for the provided type</param>
  114. </member>
  115. <member name="M:Microsoft.Extensions.DependencyInjection.SwaggerGenOptionsExtensions.MapType``1(Swashbuckle.AspNetCore.SwaggerGen.SwaggerGenOptions,System.Func{Microsoft.OpenApi.Models.OpenApiSchema})">
  116. <summary>
  117. Provide a custom mapping, for a given type, to the Swagger-flavored JSONSchema
  118. </summary>
  119. <typeparam name="T">System type</typeparam>
  120. <param name="swaggerGenOptions"></param>
  121. <param name="schemaFactory">A factory method that generates Schema's for the provided type</param>
  122. </member>
  123. <member name="M:Microsoft.Extensions.DependencyInjection.SwaggerGenOptionsExtensions.UseInlineDefinitionsForEnums(Swashbuckle.AspNetCore.SwaggerGen.SwaggerGenOptions)">
  124. <summary>
  125. Generate inline schema definitions (as opposed to referencing a shared definition) for enum parameters and properties
  126. </summary>
  127. <param name="swaggerGenOptions"></param>
  128. </member>
  129. <member name="M:Microsoft.Extensions.DependencyInjection.SwaggerGenOptionsExtensions.CustomSchemaIds(Swashbuckle.AspNetCore.SwaggerGen.SwaggerGenOptions,System.Func{System.Type,System.String})">
  130. <summary>
  131. Provide a custom strategy for generating the unique Id's that are used to reference object Schema's
  132. </summary>
  133. <param name="swaggerGenOptions"></param>
  134. <param name="schemaIdSelector">
  135. A lambda that returns a unique identifier for the provided system type
  136. </param>
  137. </member>
  138. <member name="M:Microsoft.Extensions.DependencyInjection.SwaggerGenOptionsExtensions.IgnoreObsoleteProperties(Swashbuckle.AspNetCore.SwaggerGen.SwaggerGenOptions)">
  139. <summary>
  140. Ignore any properties that are decorated with the ObsoleteAttribute
  141. </summary>
  142. </member>
  143. <member name="M:Microsoft.Extensions.DependencyInjection.SwaggerGenOptionsExtensions.UseAllOfForInheritance(Swashbuckle.AspNetCore.SwaggerGen.SwaggerGenOptions)">
  144. <summary>
  145. Enables composite schema generation. If enabled, subtype schemas will contain the allOf construct to
  146. incorporate properties from the base class instead of defining those properties inline.
  147. </summary>
  148. <param name="swaggerGenOptions"></param>
  149. </member>
  150. <member name="M:Microsoft.Extensions.DependencyInjection.SwaggerGenOptionsExtensions.UseOneOfForPolymorphism(Swashbuckle.AspNetCore.SwaggerGen.SwaggerGenOptions)">
  151. <summary>
  152. Enables polymorphic schema generation. If enabled, request and response schemas will contain the oneOf
  153. construct to describe sub types as a set of alternative schemas.
  154. </summary>
  155. <param name="swaggerGenOptions"></param>
  156. </member>
  157. <member name="M:Microsoft.Extensions.DependencyInjection.SwaggerGenOptionsExtensions.SelectSubTypesUsing(Swashbuckle.AspNetCore.SwaggerGen.SwaggerGenOptions,System.Func{System.Type,System.Collections.Generic.IEnumerable{System.Type}})">
  158. <summary>
  159. To support polymorphism and inheritance behavior, Swashbuckle needs to detect the "known" subtypes for a given base type.
  160. That is, the subtypes exposed by your API. By default, this will be any subtypes in the same assembly as the base type.
  161. To override this, you can provide a custom selector function. This setting is only applicable when used in conjunction with
  162. UseOneOfForPolymorphism and/or UseAllOfForInheritance.
  163. </summary>
  164. <param name="swaggerGenOptions"></param>
  165. <param name="customSelector"></param>
  166. </member>
  167. <member name="M:Microsoft.Extensions.DependencyInjection.SwaggerGenOptionsExtensions.SelectDiscriminatorNameUsing(Swashbuckle.AspNetCore.SwaggerGen.SwaggerGenOptions,System.Func{System.Type,System.String})">
  168. <summary>
  169. If the configured serializer supports polymorphic serialization/deserialization by emitting/accepting a special "discriminator" property,
  170. and UseOneOfForPolymorphism is enabled, then Swashbuckle will include a description for that property based on the serializer's behavior.
  171. However, if you've customized your serializer to support polymorphism, you can provide a custom strategy to tell Swashbuckle which property,
  172. for a given type, will be used as a discriminator. This setting is only applicable when used in conjunction with UseOneOfForPolymorphism.
  173. </summary>
  174. <param name="swaggerGenOptions"></param>
  175. <param name="customSelector"></param>
  176. </member>
  177. <member name="M:Microsoft.Extensions.DependencyInjection.SwaggerGenOptionsExtensions.SelectDiscriminatorValueUsing(Swashbuckle.AspNetCore.SwaggerGen.SwaggerGenOptions,System.Func{System.Type,System.String})">
  178. <summary>
  179. If the configured serializer supports polymorphic serialization/deserialization by emitting/accepting a special "discriminator" property,
  180. and UseOneOfForPolymorphism is enabled, then Swashbuckle will include a mapping of possible discriminator values to schema definitions.
  181. However, if you've customized your serializer to support polymorphism, you can provide a custom mapping strategy to tell Swashbuckle what
  182. the discriminator value should be for a given sub type. This setting is only applicable when used in conjunction with UseOneOfForPolymorphism.
  183. </summary>
  184. <param name="swaggerGenOptions"></param>
  185. <param name="customSelector"></param>
  186. </member>
  187. <member name="M:Microsoft.Extensions.DependencyInjection.SwaggerGenOptionsExtensions.UseAllOfToExtendReferenceSchemas(Swashbuckle.AspNetCore.SwaggerGen.SwaggerGenOptions)">
  188. <summary>
  189. Extend reference schemas (using the allOf construct) so that contextual metadata can be applied to all parameter and property schemas
  190. </summary>
  191. <param name="swaggerGenOptions"></param>
  192. </member>
  193. <member name="M:Microsoft.Extensions.DependencyInjection.SwaggerGenOptionsExtensions.SupportNonNullableReferenceTypes(Swashbuckle.AspNetCore.SwaggerGen.SwaggerGenOptions)">
  194. <summary>
  195. Enable detection of non nullable reference types to set Nullable flag accordingly on schema properties
  196. </summary>
  197. <param name="swaggerGenOptions"></param>
  198. </member>
  199. <member name="M:Microsoft.Extensions.DependencyInjection.SwaggerGenOptionsExtensions.InferSecuritySchemes(Swashbuckle.AspNetCore.SwaggerGen.SwaggerGenOptions,System.Func{System.Collections.Generic.IEnumerable{Microsoft.AspNetCore.Authentication.AuthenticationScheme},System.Collections.Generic.IDictionary{System.String,Microsoft.OpenApi.Models.OpenApiSecurityScheme}})">
  200. <summary>
  201. Automatically infer security schemes from authentication/authorization state in ASP.NET Core.
  202. </summary>
  203. <param name="swaggerGenOptions"></param>
  204. <param name="securitySchemesSelector">
  205. Provide alternative implementation that maps ASP.NET Core Authentication schemes to Open API security schemes
  206. </param>
  207. <remarks>Currently only supports JWT Bearer authentication</remarks>
  208. </member>
  209. <member name="M:Microsoft.Extensions.DependencyInjection.SwaggerGenOptionsExtensions.SchemaFilter``1(Swashbuckle.AspNetCore.SwaggerGen.SwaggerGenOptions,System.Object[])">
  210. <summary>
  211. Extend the Swagger Generator with "filters" that can modify Schemas after they're initially generated
  212. </summary>
  213. <typeparam name="TFilter">A type that derives from ISchemaFilter</typeparam>
  214. <param name="swaggerGenOptions"></param>
  215. <param name="arguments">Optionally inject parameters through filter constructors</param>
  216. </member>
  217. <member name="M:Microsoft.Extensions.DependencyInjection.SwaggerGenOptionsExtensions.ParameterFilter``1(Swashbuckle.AspNetCore.SwaggerGen.SwaggerGenOptions,System.Object[])">
  218. <summary>
  219. Extend the Swagger Generator with "filters" that can modify Parameters after they're initially generated
  220. </summary>
  221. <typeparam name="TFilter">A type that derives from IParameterFilter</typeparam>
  222. <param name="swaggerGenOptions"></param>
  223. <param name="arguments">Optionally inject parameters through filter constructors</param>
  224. </member>
  225. <member name="M:Microsoft.Extensions.DependencyInjection.SwaggerGenOptionsExtensions.RequestBodyFilter``1(Swashbuckle.AspNetCore.SwaggerGen.SwaggerGenOptions,System.Object[])">
  226. <summary>
  227. Extend the Swagger Generator with "filters" that can modify RequestBodys after they're initially generated
  228. </summary>
  229. <typeparam name="TFilter">A type that derives from IRequestBodyFilter</typeparam>
  230. <param name="swaggerGenOptions"></param>
  231. <param name="arguments">Optionally inject parameters through filter constructors</param>
  232. </member>
  233. <member name="M:Microsoft.Extensions.DependencyInjection.SwaggerGenOptionsExtensions.OperationFilter``1(Swashbuckle.AspNetCore.SwaggerGen.SwaggerGenOptions,System.Object[])">
  234. <summary>
  235. Extend the Swagger Generator with "filters" that can modify Operations after they're initially generated
  236. </summary>
  237. <typeparam name="TFilter">A type that derives from IOperationFilter</typeparam>
  238. <param name="swaggerGenOptions"></param>
  239. <param name="arguments">Optionally inject parameters through filter constructors</param>
  240. </member>
  241. <member name="M:Microsoft.Extensions.DependencyInjection.SwaggerGenOptionsExtensions.DocumentFilter``1(Swashbuckle.AspNetCore.SwaggerGen.SwaggerGenOptions,System.Object[])">
  242. <summary>
  243. Extend the Swagger Generator with "filters" that can modify SwaggerDocuments after they're initially generated
  244. </summary>
  245. <typeparam name="TFilter">A type that derives from IDocumentFilter</typeparam>
  246. <param name="swaggerGenOptions"></param>
  247. <param name="arguments">Optionally inject parameters through filter constructors</param>
  248. </member>
  249. <member name="M:Microsoft.Extensions.DependencyInjection.SwaggerGenOptionsExtensions.IncludeXmlComments(Swashbuckle.AspNetCore.SwaggerGen.SwaggerGenOptions,System.Func{System.Xml.XPath.XPathDocument},System.Boolean)">
  250. <summary>
  251. Inject human-friendly descriptions for Operations, Parameters and Schemas based on XML Comment files
  252. </summary>
  253. <param name="swaggerGenOptions"></param>
  254. <param name="xmlDocFactory">A factory method that returns XML Comments as an XPathDocument</param>
  255. <param name="includeControllerXmlComments">
  256. Flag to indicate if controller XML comments (i.e. summary) should be used to assign Tag descriptions.
  257. Don't set this flag if you're customizing the default tag for operations via TagActionsBy.
  258. </param>
  259. </member>
  260. <member name="M:Microsoft.Extensions.DependencyInjection.SwaggerGenOptionsExtensions.IncludeXmlComments(Swashbuckle.AspNetCore.SwaggerGen.SwaggerGenOptions,System.String,System.Boolean)">
  261. <summary>
  262. Inject human-friendly descriptions for Operations, Parameters and Schemas based on XML Comment files
  263. </summary>
  264. <param name="swaggerGenOptions"></param>
  265. <param name="filePath">An absolute path to the file that contains XML Comments</param>
  266. <param name="includeControllerXmlComments">
  267. Flag to indicate if controller XML comments (i.e. summary) should be used to assign Tag descriptions.
  268. Don't set this flag if you're customizing the default tag for operations via TagActionsBy.
  269. </param>
  270. </member>
  271. <member name="M:Microsoft.Extensions.DependencyInjection.SwaggerGenOptionsExtensions.GeneratePolymorphicSchemas(Swashbuckle.AspNetCore.SwaggerGen.SwaggerGenOptions,System.Func{System.Type,System.Collections.Generic.IEnumerable{System.Type}},System.Func{System.Type,System.String})">
  272. <summary>
  273. Generate polymorphic schemas (i.e. "oneOf") based on discovered subtypes.
  274. Deprecated: Use the \"UseOneOfForPolymorphism\" and \"UseAllOfForInheritance\" settings instead
  275. </summary>
  276. <param name="swaggerGenOptions"></param>
  277. <param name="subTypesResolver"></param>
  278. <param name="discriminatorSelector"></param>
  279. </member>
  280. </members>
  281. </doc>