swashbuckle.aspnetcore和swashbuckle包有什么不同？
swashbuckle.aspnetcore和swashbuckle包是两个与ASP.NET Core相关的开源项目，用于生成和展示API文档。它们之间的不同主要体现在以下几个方面：
- swashbuckle.aspnetcore是一个专门为ASP.NET Core开发的Swagger工具包，用于生成和展示API文档。Swagger是一种用于描述、构建和调用Web服务的规范，它可以自动生成API文档，并提供交互式的API探索界面。swashbuckle.aspnetcore提供了一些额外的功能和配置选项，以便更好地集成到ASP.NET Core应用程序中。
- swashbuckle包是一个更通用的Swagger工具包，适用于多种不同的开发框架和平台，包括ASP.NET Core。它提供了一些基本的功能，如生成Swagger规范和API文档，但可能需要更多的配置和自定义来适应特定的开发环境。
总的来说，swashbuckle.aspnetcore是专门为ASP.NET Core开发的Swagger工具包，提供了更好的集成和配置选项，而swashbuckle包是一个更通用的Swagger工具包，适用于多种开发框架和平台。在使用时，可以根据具体的开发需求和环境选择合适的工具包。
相关·内容
我正在尝试使用由Swashbuckle.AspNetCore (3.0.0)创建的Autorest和Swagger文档来生成REST API客户端。
生成的swagger文档似乎是正确的，除了操作名称并不是很好。
"/api/Addresses/{id}": {
"get": {
"tags": [ "Address" ],
"operationId": "ApiAddressesByIdGet",
"consumes":
浏览 116提问于2018-08-23得票数 20
回答已采纳
我已经升级了我的ASP.Net核心2.0应用程序，使其包含Swashbuckle.AspNetCore 2.1.0。在此之前，我们使用了Swashbuckle.AspNetCore 1.0.0。现在，当我转到我的swagger端点时，我不会得到以前显示的"Description“、"Data Type”或"Parameter“列。我已经查看了swagger.json文件，以确定它们是否存在，它们是否存在。
下面是我的新的招摇UI的截图：
这是我以前的那个：
是否有破坏的变化导致了这一点？
浏览 1提问于2018-04-16得票数 1
回答已采纳
我更新了Swashbuckle v5和operation.Parameters()是不是有效的anymore.Is有什么替代吗？
{
var apiDescription = context.ApiDescription;
operation.Deprecated |= apiDescription.IsDeprecated();
if (operation.Parameters == null)
{
return;
}
浏览 5提问于2019-11-11得票数 7
我一直在读Swashbuckle.AspNetCore和it 的文档，用来装饰各种东西来生成更丰富的Swagger API。
但是..。我们没有使用DataAnnotations。我们使用的是FluentValidation。
那么，Swashbuckle.AspNetCore库是否提供了利用FluentValidation而不是DataAnnotations的方法呢
我们不希望重复任何验证逻辑，两次。
浏览 4提问于2018-05-14得票数 0
如何在asp.net核心API中使用Swagger。我使用了核心框架-2。我试着
Swashbuckle.AspNetCore
包，但框架2不支持它。
浏览 4提问于2017-07-12得票数 2
回答已采纳
我们使用的是swagger的Swashbuckle.AspNetCore包。我们有很多返回多态对象(如SortEntry或VersionedObject )的调用，swagger中生成的组件似乎包含一堆关于这些对象的元数据，如下所示： "Data.SortEntry`1[[Data.Search.Enums.DetailsSortType, Data, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]" 我不想说太多，但这只是由于我们的流程造成的问题，我们使用生成的swagger来验证API协定。因此，这个元数据会
浏览 17提问于2020-11-03得票数 0
我已经将我的代码升级为使用Swashbuckle.AspNetCore 3.0.0。( Swashbuckle.AspNetCore.Annotations、Swashbuckle.AspNetCore.Swagger、Swashbuckle.AspNetCore.SwaggerGen、Swashbuckle.AspNetCore.SwaggerUI都是3.0.0)。
现在，当我使用[SwaggerOperation(OperationId = "MyUniqueId")]时，operationId值不是设置的，而是自动生成的。
你知道如果我做错了什么，或者这只是一个新版本的b
浏览 2提问于2018-10-26得票数 0
我的项目需要使用导入swagger，为此，我研究文档。但是根据第一步提到Nuget包，我发现Swashbuckle.AspNetCore包无法被识别。提示错误：
Nuget is neither responsible nor licensed for third-party packages.
浏览 7提问于2022-02-28得票数 0
回答已采纳
我可以提供更多细节，但不确定哪些是有用的，因此如果需要，我会提供更具体的信息。
我有一个.NET核心3.1项目，这是使用Swashbuckle来提供Swagger UI。它开始使用Swashbuckle.AspNetCore NuGet包版本5.0.0-rc4，一切正常。
我有一个控制器方法，它接受Contract对象：
public async Task<IActionResult> Import([FromBody] Contract contract) {
这只是一个非常基础的类(我在排除故障时把所有东西都去掉了)，基本上就是：
public class Contract {
浏览 7提问于2020-05-21得票数 0
当我为.net核心应用程序安装swashbuckle.aspnetcore时，我看到了两个选项：swashbuckle和swashbuckle。 有人能告诉我这两个包之间的区别吗？
浏览 17提问于2019-02-12得票数 0
回答已采纳
我在WebApi 5中有一个.Net项目，并且已经在使用Swagger与默认设置( ConfigureServices方法中的services.AddSwaggerGen()& app.UseSwagger()和app.UseSwaggerUI()在Startup.cs中的配置方法)，没有任何问题。
现在我决定通过Swashbuckle.AspNetCore.Cli创建Swagger文件。我创建了清单文件：.net new tool-manifest
然后安装Swashbuckle.AspNetCore.Cli:dotnet tool install --version 6.2.3 S
浏览 12提问于2022-01-05得票数 2
如何使用Swashbuckle.AspNetCore v4.0.1禁用Swagger文档和Swagger UI的HTTP端点？ 我们所有的服务都需要HTTPS，文档也需要HTTPS。 我已经查找了关于这方面的文档，但是我还没有找到任何关于Swashbuckle.AspNetCore的文档。我已经看到一些非核心版本的related questions，但是引用的属性/方法在核心上不可用。
浏览 7提问于2019-06-19得票数 0
我的swagger ui显示"Parameter content type“，其中包含各种条目："application/json-patch+json"、"text/json"、"application/json"和"application/*+json"。
我只想要"application/json"
在存储库上有一个未解决的问题，它使用这种可视化(较旧的ui，但想法相同)：
有什么方法可以设置这个吗？
Swashbuckle.AspNetCore版本4.0.1
Swashbuckle.Asp
浏览 0提问于2019-05-04得票数 18
回答已采纳
我使用的是Swashbuckle.AspNetCore，我想通过XML文档为一个参数显示多个示例。我看到规范允许它()，但我似乎不知道如何使用Swashbuckle.AspNetCore来实现它。有可能吗？
我试过以下几种方法
<example>"item 1","item 2"</example> In swagger，示例不是added.
<example>["item 1","item 2"]</example> 我认为只有当参数是数组时才应该使用，所以不使用go.
浏览 5提问于2022-09-28得票数 0
回答已采纳
我正在使用swagger，但根据的说法，我有这个问题。nuget软件包尚未成功下载。我该怎么办？
这是错误消息：
严重性代码描述项目文件行抑制状态错误feed'nuget.org https://api.nuget.org/v3/index.json‘列出package'Swashbuckle.AspNetCore.SwaggerUI.6.2.3’，但是多次下载nupkg的尝试都失败了。当当前操作正在进行时，提要无效或必需的包被移除。验证包是否存在于提要中，然后再试一次。找不到package'Swashbuckle.AspNetCore.SwaggerUI.6.2.3
浏览 2提问于2021-12-12得票数 3
回答已采纳
1回答
我正在使用Swashbuckle.AspNetCore创建我的swagger。
我可以按我想要的方式在一个组内排序操作，但是如何排序组本身呢？
例句:正确的顺序是: ContratedDemand，需求，订阅和用户，但我得到的图片如下。
我使用的是Swashbuckle.AspNetCore 1.2.0
更新:根据@HelderSepu (tks!)，我必须设置标签，操作将根据它们进行排序。
那么，如何按照我想要的方式设置标签呢？
浏览 0提问于2018-07-16得票数 0
我一直在跟踪，使用Swashbuckle为我的ASP.Net REST WebApi创建开发人员友好文档。然而，当前版本的Swashbuckle.AspNetCore v2.2.0生成一个巨大的单页应用程序，这让我的用户感到困惑。如果我没记错的话，Swashbuckle为每个控制器/方法生成了单独的页面(2017年初？)。我的配置如下所示：
app.UseSwaggerUI(c =>
{
c.SwaggerEndpoint("/swagger/v1/swagger.json", "API V1");
c.EnableFilter();
浏览 0提问于2018-03-06得票数 7
1回答
所需的nuget软件包是什么？
、、、、
我正在构建一个.Net Core3.1 WebAPI，我将在上部署它。我想启用
目前，我有以下的nuget套餐
<ItemGroup>
<PackageReference Include="Microsoft.ApplicationInsights" Version="2.20.0" />
<PackageReference Include="Microsoft.ApplicationInsights.Agent.Intercept" Version="2.4.0" />
浏览 9提问于2022-06-08得票数 0
回答已采纳
我创造了一个新的解决方案，我增加了一些项目。它们要么是ASP.NET核心、类库，要么是NUnit测试项目。ASP.NET和测试项目都会遇到相同的错误，在这些错误中，我无法向项目中添加包。我得到的错误是NU1202，几个例子：
Error NU1202 Package Newtonsoft.Json 10.0.1 is not compatible with netcoreapp3.0 (.NETCoreApp,Version=v3.0).
Package Newtonsoft.Json 10.0.1 does not support any target frameworks.
浏览 3提问于2019-10-29得票数 3
我有一个ASP.NET Corev2.1和Swashbuckle.AspNetCore包。
我有以下错误响应模型：
public class ErrorResponse
{
[JsonProperty(PropertyName = "error")]
public Error Error { get; set; }
}
public class Error
{
[JsonProperty(PropertyName = "code")]
public string Code { get; set; }
[JsonProp
浏览 1提问于2019-05-17得票数 2
回答已采纳
1回答
我插入了Swashbuckle.AspNetCore，并开始使用swagger UI来调试我的Rest API。我很乐意得到对象的每个属性的输入，而不是整个对象的大文本区。我该怎么做呢？
浏览 0提问于2019-04-18得票数 0
我已经创建了一个.NET Core Web，并且正在跟随添加对swagger的支持。
我已经添加了Swashbuckle.AspNetCore nuget包，但是当我添加using Swashbuckle.AspNetCore.Swagger;时，在Swashbuckle下面有一个红色的曲线。我无法调用AddSwaggerGen
有没有人有工作样本，或者知道我哪里出错了？
浏览 2提问于2017-06-14得票数 0
回答已采纳
我正在挣扎于我刚刚在Visual 2019上创建的一个项目。这是一个.net C#项目。当我启动项目时，我会得到以下错误：
“无法找到包Swashbuckle.AspNetCore。源代码中没有此id的包: Microsoft脱机包”
我试过安装这个软件包，但它不起作用。我已经安装了这个软件包，你可以在这里看到：
你觉得我该怎么办？
浏览 16提问于2021-12-21得票数 4
我正在将一个Web从.NET框架迁移到ASP.NET内核，该API具有使用Swashbuckle生成的Swagger文档。在新的AspNetCore版本中，我使用的是Swashbuckle.AspNetCore v5.0.0-rc2。
这是一个内部服务，身份验证使用自定义HTTP报头中提供的API密钥。在.NET框架应用程序中，我将配置为启用API密钥，如下所示：
c.ApiKey("apiKey")
.Description("My description")
.Name("MyHttpHeaderName")
.In(
浏览 0提问于2019-09-15得票数 9
回答已采纳
在我将Swashbuckle.AspNetCore包添加到我的ASP.NET Core3.1Web API项目中之后，我无法调用AddSwaggerGen函数。 我做错了什么？ ?
浏览 105提问于2020-07-19得票数 1
回答已采纳
斯瓦什巴克尔需要什么样的配置才能在PascalCase中显示与后端完全相同的枚举值？
我并不是在寻找全球性的变化，其他的一切都很有效，看起来也很棒，只是一些小天地而已。链接到官方文件将是很棒的！
.NET核心2.1
Swashbuckle.AspNetCore 5.6.3
Swashbuckle.AspNetCore.Filters 5.1.2
Swashbuckle.AspNetCore.Newtonsoft 5.6.3
浏览 3提问于2020-09-30得票数 0
我在一个项目中使用Swashbuckle.AspNetCore。我开始使用的版本是5.5.1，当使用大型主体(20k json行)呈现结果时，速度非常合理(数据获取需要50 was，呈现时间不到1秒钟)。当我升级到5.6.x时，语法现在被高亮显示(看起来不错)，但是将这些结果的呈现速度减慢到超过20秒。一旦呈现，页面上任何导致刷新的操作都需要20秒才能清除结果。
在通常的搜索之后，我想尝试这个解决方案(停用syntaxHighlight)。我不知道如何通过Swashbuckle.AspNetCore实现这一点。有什么建议吗？
SwaggerUI({
syntaxHighligh
浏览 5提问于2020-09-24得票数 5
回答已采纳
1回答
我在使用.net核心样板框架的swagger中得到了以下错误。我在'Startup.cs‘中做了必要的配置。我在项目中加入了Swagger。Swashbuckle.AspNetCore包版本:5.5.1如何解决此问题？ InvalidOperationException:尝试调用中间件'Swashbuckle.AspNetCore.Swagger.SwaggerMiddleware'.时无法解析类型'Swashbuckle.AspNetCore.Swagger.ISwaggerProvider‘的服务
浏览 18提问于2021-07-07得票数 0
1回答
如何恢复nuget包，包括在使用azure构建管道时的预发布？
- task: NuGetCommand@2
displayName: Restore
inputs:
command: 'restore'
restoreSolution: '**/*.sln'
feedsToUse: 'select'
vstsFeed: '<guid>'
错误
Package Swashbuckle.AspNetCore 5.0.0-rc2 is not compatible with netc
浏览 1提问于2019-12-09得票数 1
回答已采纳
2回答
我有一个需求，我想根据用户角色在swagger中列出api方法。
例如:-
具有基本访问权限的用户A可以使用有限的api方法。
具有access的用户B可以使用所有列出的api方法。
我不知道怎么做到这一点。
我正在使用Swashbuckle.AspNetCore Version="1.0.0"
浏览 5提问于2017-07-04得票数 0
我试图将swagger集成到ASP NET Core 3.0项目中，它会在ConfigureServices方法中抛出异常：
我使用的是Swashbuckle.AspNetCore 4.0.1。
我还检查了这个和
public void ConfigureServices(IServiceCollection services)
{
services.AddSwaggerGen(c =>
{
c.SwaggerDoc("v1", new Swashbuckle.AspNet
浏览 19提问于2019-11-05得票数 7
回答已采纳
是否有人成功地获得了复杂的Swagger请求和响应示例，以便通过.NET 6中的Swagger呈现？
我正在.NET 6 RC 1上尝试使用Swashbuckle.AspNetCore 6.2.1和Swashbuckle.AspNetCore.Filters 7.0.2。说“不要忘记启用ExamplesOperationFilter"，但我甚至找不到ExamplesOperationFilter的定义。它在哪里?
我已经看到了XML标记的东西，但这对于我的需要来说太简单了--我有嵌套数组、列表和枚举，以及我想要显示的各种东西。
浏览 9提问于2021-09-22得票数 2
回答已采纳
我正在尝试使用swaggergen工具，所以我配置了我的服务：
services.AddSwaggerGen(c =>
{
c.SerializeAsV2 = true;
c.CustomOperationIds(apiDescription => {
return apiDescription.TryGetMethodInfo(out MethodInfo methodInfo) ? methodInfo.Name : null;
});
我在n
浏览 9提问于2020-02-07得票数 0
回答已采纳
首先，这在Swashbuckle.AspNetCore v4中运行良好。因此，给定这个模型和端点；
public class TestRequest
{
public string test1 { get; set; }
public string test2;
}
[HttpPost]
public void Post([FromBody] TestRequest value)
{
}
Swagger只显示；
{
"test1": "string"
}
作为示例TestRequest值。
这种行为现在是有意的吗？有没有办法通过设置或过滤器
浏览 0提问于2020-01-11得票数 2
我最近使用ASP.NET Core3.1将一个ASP.NET核心API应用程序升级到了Swashbuckle/Swagger5.0.0。
<PackageReference Include="Swashbuckle.AspNetCore" Version="5.0.0" />
<PackageReference Include="Swashbuckle.AspNetCore.Swagger" Version="5.0.0" />
<PackageReference Include="Swash
浏览 19提问于2020-02-17得票数 11
回答已采纳
我试图第一次使用swashbuckle/swagger，遇到了一个小问题，在这里，swashbuckle被用来生成swagger.json文件，然后swagger构建了客户机，但是导入这两个包会导致一个不明确的调用，如果我试图指定调用，它就不会将调用的路径注册为有效。
具体来说，app.UseSwagger()；被标记为模棱两可的调用，nswag.aspnetcore和swashbuckle.aspnetcore是包。
简单地说，我如何指定调用或调用所需的包，是否有办法在一起避免冲突？提前感谢
浏览 0提问于2018-12-05得票数 0
回答已采纳
我无法在我的笔记本电脑上解决一个新的webapi项目中的nuget错误，但是在另一个笔记本上工作很好。它们都有相同的VS Code、nuget、dotnet核心版本，并且具有相同的项目文件
错误NU1100:无法解析“net6.0”的“Swashbuckle.AspNetCore (>= 6.2.3)”。
<Project Sdk="Microsoft.NET.Sdk.Web">
<PropertyGroup>
<TargetFramework>net6.0</TargetFramework>
&l
浏览 11提问于2021-12-26得票数 0
我有ASP.NET Core应用程序，在这里我使用了下面的swagger：
public void ConfigureServices(IServiceCollection services)
{
services.AddMvc();
services.AddSwaggerGen(c =>
{
c.OperationFilter<ExamplesOperationFilter>();
c.OperationFilter<DescriptionOperationFilter>();
c.Swag
浏览 1提问于2018-08-14得票数 11
回答已采纳
Swashbuckle.AspNetCore 创建一个新的ASP.NET Core2.2项目，目标是.NET Framework4.8，按照“开始”添加ASP.NET
这给出了这个存储库：
BuildGo文件夹中的'bin/net48'Execute命令：swagger tofile WebApplication1.exe v1
显示错误：
A JSON parsing exception occurred in [.\WebApplication1\bin\Debug\net48\WebApplication1.exe]: * Line 1, Column 2 Syntax
浏览 2提问于2020-05-04得票数 1
回答已采纳
我在下面的问题Asp.Net Core swagger Help Pages for IFormFile中找到了我的问题的适当解决方案 不幸的是，此代码仅适用于与.Net Core3.1版本不兼容的较旧的'Swashbuckle.AspNetCore‘包。 谁能帮我更新这段代码，这样它就可以在.Net Core3.1版本中正常运行了？ 谢谢!
浏览 9提问于2021-04-02得票数 0
我正在考虑在我的ASP.Net核心项目中使用Swashbuckle.AspNetCore v4.0.1API包来为我的web生成一个SwaggerUI文档端点，该端点将被我公司内部的各个团队使用。我的API使用并发出一些消息总线事件和命令，我希望将它们包含在该文档中。
Swashbuckle的中间件中是否有任何自定义设置允许我记录与API端点无关的输入/输出对象？
浏览 3提问于2018-11-10得票数 0
我安装了运行以下程序的EntityFrameworkCore.Design。
Install-Package Microsoft.EntityFrameworkCore.Design -Version 3.0.0-preview6.19304.10
它似乎是安装的，我可以在VS中看到以下内容。
但是，当我尝试使用
dotnet ef migrations add Init
我有相当长的时间等待，然后是下面的错误。
您的启动项目“Web”没有引用Microsoft.EntityFrameworkCore.Design。该软件包是实体框架核心工具工作所必需的。确保启动项目是正确的，安装
浏览 0提问于2019-07-17得票数 0
回答已采纳
我正在尝试更新REST的API文档。
目前，我有一个C# Asp.net Web代码和Swashbuckle.AspNetCore。我正在使用Visual在C#中编辑和添加XML注释，以更新API文档。
我是否可以使用SwaggerHub或其他允许我使用Markdown的工具来完成这个任务呢？
我还没有在网上找到任何解决方案。
浏览 11提问于2022-03-08得票数 0
4回答
我在终点站收到这样的消息：
错误NU1100:无法解析“net5.0”的“Swashbuckle.AspNetCore (>= 5.6.3)”
我试着在恢复时运行dotnet还原，但它不会恢复
浏览 20提问于2021-05-05得票数 11
目前使用Swashbuckle.AspNetCore 1.1.0版本的应用程序今年的目标是在.net核心3.1或.net 5上执行框架，同时将Swashbuckle.AspNetCore升级到6.1.5，找出不再具有可操作性，需要自定义的参考。
我关心的是如何获得相同的操作(与版本1.1.0相同)
下面是我从1.1.0版本中获得的骄傲自大的json结果的示例
具有参数(困难)的api路由
{
"/api/Games/{id}": {
"post": {
"tags": ["Games"
浏览 2提问于2021-08-26得票数 0
2回答
在构建时生成Swagger
、、、、
我正在从事一个ASP.NET核心WebAPI项目，并试图找到一种方法在构建时生成高傲的json？
由于我使用的是4个环境，所以我希望有4个swagger.json具有不同的名称，比如：
swagger_{appName}dev{buildNumber}.json
swagger_{appName}demo{buildNumber}.json
swagger_{appName}int{buildNumber}.json
Swagger_{appName}分期{buildNumber}.json
是否也可以编辑json中的字段？我想编辑(视环境而定)以下字段:主机、方案和b
浏览 1提问于2018-02-06得票数 10
2回答
我试图将Swagger添加到我的ASP.Net Core项目中，如下所示：
public void ConfigureServices(IServiceCollection services)
{
services.AddControllers();
services.AddSwaggerGen(c =>
{
c.SwaggerDoc("v0.1", new OpenApiInfo { Title = "My API", Version = "v0.1" });
}
浏览 1提问于2019-11-11得票数 2
回答已采纳
services.AddSwaggerGen(x =>
{
});
我探索了AddSwaggerGen() NuGet Swashbuckle.AspNetCore的方法。不幸的是，我还没有找到使用已经生成的开放API规范文件的path的方法。
我的API与.net核心中的文件上传有关，我已经编写了swagger规范文件swagger.yaml，它在中运行良好。有谁可以帮我？如何将生成的开放式API规范文件注入到SwaggerUI中，并将其与.net核中的NuGet Swashbuckle.AspNetCore一起使用
app.UseSwaggerUI(
浏览 3提问于2021-04-27得票数 1
我有这个动作方法： [HttpGet]
public async Task<ActionResult<Agent[]>> Get(DateTime? lastModified = null) {} 我可以看到下面的swagger json是使用Swashbuckle.AspNetCore v4.0.1生成的： "parameters":[{"name":"lastModified","in":"query","required":false,"type":&
浏览 91提问于2019-08-28得票数 2
回答已采纳
我正在开发一个Azure服务，在该服务中，我使用了Swashbuckle.AspNetCore来构建API列表。我在Startup.cs文件中使用以下代码
在ConfigureServices(IServiceCollection服务)中
services.AddSwaggerGen(c =>
{
c.SwaggerDoc("Backend", new Info { Title = "My Backend", Version = "v1.0" });
浏览 0提问于2018-09-01得票数 1
回答已采纳
扫码
添加站长 进交流群
领取专属 10元无门槛券
手把手带您无忧上云
相关资讯
热门标签
云服务器
ICP备案
实时音视频
对象存储
云直播活动推荐
腾讯云开发者
