Update README.md

This commit is contained in:
sunkaixuan
2017-05-31 16:03:17 +08:00
committed by GitHub
parent 0cf6047139
commit e8a8a255f1

425
README.md
View File

@@ -16,145 +16,120 @@ SqlSugarClient db = new SqlSugarClient(new ConnectionConfig() { ConnectionString
### 1.2 Introduction ### 1.2 Introduction
```c ```c
var getAll = db.Queryable<Student> var getAll = db.Queryable<Student>().ToList();
().ToList(); var getAllNoLock = db.Queryable<Student>().With(SqlWith.NoLock).ToList();
var getAllNoLock = db.Queryable<Student> var getByPrimaryKey = db.Queryable<Student>().InSingle(2);
().With(SqlWith.NoLock).ToList(); var getByWhere = db.Queryable<Student>().Where(it => it.Id == 1 || it.Name == "a").ToList();
var getByPrimaryKey = db.Queryable<Student> var getByFuns = db.Queryable<Student>().Where(it => SqlFunc.IsNullOrEmpty(it.Name)).ToList();
().InSingle(2); var sum = db.Queryable<Student>().Sum(it=>it.Id);
var getByWhere = db.Queryable<Student> var isAny = db.Queryable<Student>().Where(it=>it.Id==-1).Any();
().Where(it => it.Id == 1 || it.Name == "a").ToList(); var isAny2 = db.Queryable<Student>().Any(it => it.Id == -1);
var getByFuns = db.Queryable<Student> var getListByRename = db.Queryable<School>().AS("Student").ToList();
().Where(it => SqlFunc.IsNullOrEmpty(it.Name)).ToList(); var group = db.Queryable<Student>().GroupBy(it => it.Id)
var sum = db.Queryable<Student> .Having(it => SqlFunc.AggregateCount(it.Id) > 10)
().Sum(it=>it.Id); .Select(it =>new { id = SqlFunc.AggregateCount(it.Id) }).ToList();
var isAny = db.Queryable<Student> ```
().Where(it=>it.Id==-1).Any();
var isAny2 = db.Queryable<Student>
().Any(it => it.Id == -1);
var getListByRename = db.Queryable<School>
().AS("Student").ToList();
var group = db.Queryable<Student>
().GroupBy(it => it.Id)
.Having(it => SqlFunc.AggregateCount(it.Id) > 10)
.Select(it =>new { id = SqlFunc.AggregateCount(it.Id) }).ToList();
```
### 1.3 Page ### 1.3 Page
```c ```c
var pageIndex = 1; var pageIndex = 1;
var pageSize = 2; var pageSize = 2;
var totalCount = 0; var totalCount = 0;
//page //page
var page = db.Queryable<Student> var page = db.Queryable<Student>().ToPageList(pageIndex, pageSize, ref totalCount);
().ToPageList(pageIndex, pageSize, ref totalCount);
//page join //page join
var pageJoin = db.Queryable<Student, School> var pageJoin = db.Queryable<Student, School>((st, sc) => new object[] {
((st, sc) => new object[] { JoinType.Left,st.SchoolId==sc.Id
JoinType.Left,st.SchoolId==sc.Id }).ToPageList(pageIndex, pageSize, ref totalCount);
}).ToPageList(pageIndex, pageSize, ref totalCount);
//top 5 //top 5
var top5 = db.Queryable<Student> var top5 = db.Queryable<Student>().Take(5).ToList();
().Take(5).ToList();
//skip5 //skip5
var skip5 = db.Queryable<Student> var skip5 = db.Queryable<Student>().Skip(5).ToList();
().Skip(5).ToList(); ```
```
### 1.4 Join ### 1.4 Join
```c ```c
//join 2 //join 2
var list = db.Queryable<Student, School> var list = db.Queryable<Student, School>((st, sc) => new object[] {
((st, sc) => new object[] { JoinType.Left,st.SchoolId==sc.Id
JoinType.Left,st.SchoolId==sc.Id })
}) .Where(st=>st.Name=="jack").ToList();
.Where(st=>st.Name=="jack").ToList();
//join 3 //join 3
var list2 = db.Queryable<Student, School,Student> var list2 = db.Queryable<Student, School,Student>((st, sc,st2) => new object[] {
((st, sc,st2) => new object[] { JoinType.Left,st.SchoolId==sc.Id,
JoinType.Left,st.SchoolId==sc.Id, JoinType.Left,st.SchoolId==st2.Id
JoinType.Left,st.SchoolId==st2.Id })
}) .Where((st, sc, st2)=> st2.Id==1||sc.Id==1||st.Id==1).ToList();
.Where((st, sc, st2)=> st2.Id==1||sc.Id==1||st.Id==1).ToList();
//join return List<ViewModelStudent> //join return List<ViewModelStudent>
var list3 = db.Queryable<Student, School> var list3 = db.Queryable<Student, School>((st, sc) => new object[] {
((st, sc) => new object[] { JoinType.Left,st.SchoolId==sc.Id
JoinType.Left,st.SchoolId==sc.Id }).Select((st,sc)=>new ViewModelStudent { Name= st.Name,SchoolId=sc.Id }).ToList();
}).Select((st,sc)=>new ViewModelStudent { Name= st.Name,SchoolId=sc.Id }).ToList();
//join Order By (order by st.id desc,sc.id desc) //join Order By (order by st.id desc,sc.id desc)
var list4 = db.Queryable<Student, School> var list4 = db.Queryable<Student, School>((st, sc) => new object[] {
((st, sc) => new object[] { JoinType.Left,st.SchoolId==sc.Id
JoinType.Left,st.SchoolId==sc.Id })
}) .OrderBy(st=>st.Id,OrderByType.Desc)
.OrderBy(st=>st.Id,OrderByType.Desc) .OrderBy((st,sc)=>sc.Id,OrderByType.Desc)
.OrderBy((st,sc)=>sc.Id,OrderByType.Desc) .Select((st, sc) => new ViewModelStudent { Name = st.Name, SchoolId = sc.Id }).ToList();
.Select((st, sc) => new ViewModelStudent { Name = st.Name, SchoolId = sc.Id }).ToList(); ```
```
### 1.5 SqlFunctions ### 1.5 SqlFunctions
```c ```c
var t1 = db.Queryable<Student> var t1 = db.Queryable<Student>().Where(it => SqlFunc.ToLower(it.Name) == SqlFunc.ToLower("JACK")).ToList();
().Where(it => SqlFunc.ToLower(it.Name) == SqlFunc.ToLower("JACK")).ToList(); //SELECT [Id],[SchoolId],[Name],[CreateTime] FROM [Student] WHERE ((LOWER([Name])) = (LOWER(@MethodConst0)) )
//SELECT [Id],[SchoolId],[Name],[CreateTime] FROM [Student] WHERE ((LOWER([Name])) = (LOWER(@MethodConst0)) )
/***More Functions***/ /***More Functions***/
//SqlFunc.IsNullOrEmpty(object thisValue) //SqlFunc.IsNullOrEmpty(object thisValue)
//SqlFunc.ToLower(object thisValue) //SqlFunc.ToLower(object thisValue)
//SqlFunc.string ToUpper(object thisValue) //SqlFunc.string ToUpper(object thisValue)
//SqlFunc.string Trim(object thisValue) //SqlFunc.string Trim(object thisValue)
//SqlFunc.bool Contains(string thisValue, string parameterValue) //SqlFunc.bool Contains(string thisValue, string parameterValue)
//SqlFunc.ContainsArray(object[] thisValue, string parameterValue) //SqlFunc.ContainsArray(object[] thisValue, string parameterValue)
//SqlFunc.StartsWith(object thisValue, string parameterValue) //SqlFunc.StartsWith(object thisValue, string parameterValue)
//SqlFunc.EndsWith(object thisValue, string parameterValue) //SqlFunc.EndsWith(object thisValue, string parameterValue)
//SqlFunc.Equals(object thisValue, object parameterValue) //SqlFunc.Equals(object thisValue, object parameterValue)
//SqlFunc.DateIsSame(DateTime date1, DateTime date2) //SqlFunc.DateIsSame(DateTime date1, DateTime date2)
//SqlFunc.DateIsSame(DateTime date1, DateTime date2, DateType dataType) //SqlFunc.DateIsSame(DateTime date1, DateTime date2, DateType dataType)
//SqlFunc.DateAdd(DateTime date, int addValue, DateType millisecond) //SqlFunc.DateAdd(DateTime date, int addValue, DateType millisecond)
//SqlFunc.DateAdd(DateTime date, int addValue) //SqlFunc.DateAdd(DateTime date, int addValue)
//SqlFunc.DateValue(DateTime date, DateType dataType) //SqlFunc.DateValue(DateTime date, DateType dataType)
//SqlFunc.Between(object value, object start, object end) //SqlFunc.Between(object value, object start, object end)
//SqlFunc.ToInt32(object value) //SqlFunc.ToInt32(object value)
//SqlFunc.ToInt64(object value) //SqlFunc.ToInt64(object value)
//SqlFunc.ToDate(object value) //SqlFunc.ToDate(object value)
//SqlFunc.ToString(object value) //SqlFunc.ToString(object value)
//SqlFunc.ToDecimal(object value) //SqlFunc.ToDecimal(object value)
//SqlFunc.ToGuid(object value) //SqlFunc.ToGuid(object value)
//SqlFunc.ToDouble(object value) //SqlFunc.ToDouble(object value)
//SqlFunc.ToBool(object value) //SqlFunc.ToBool(object value)
//SqlFunc.Substring(object value, int index, int length) //SqlFunc.Substring(object value, int index, int length)
//SqlFunc.Replace(object value, string oldChar, string newChar) //SqlFunc.Replace(object value, string oldChar, string newChar)
//SqlFunc.Length(object value) { throw new NotImplementedException(); } //SqlFunc.Length(object value) { throw new NotImplementedException(); }
//SqlFunc.AggregateSum(object thisValue) //SqlFunc.AggregateSum(object thisValue)
//SqlFunc.AggregateAvg<TResult> //SqlFunc.AggregateAvg<TResult>(TResult thisValue)
(TResult thisValue) //SqlFunc.AggregateMin(object thisValue)
//SqlFunc.AggregateMin(object thisValue) //SqlFunc.AggregateMax(object thisValue)
//SqlFunc.AggregateMax(object thisValue) //SqlFunc.AggregateCount(object thisValue)
//SqlFunc.AggregateCount(object thisValue) ```
```
### 1.6 Select ### 1.6 Select
```c ```c
var s1 = db.Queryable<Student> var s1 = db.Queryable<Student>().Select(it => new ViewModelStudent2 { Name = it.Name, Student = it }).ToList();
().Select(it => new ViewModelStudent2 { Name = it.Name, Student = it }).ToList(); var s2 = db.Queryable<Student>().Select(it => new { id = it.Id, w = new { x = it } }).ToList();
var s2 = db.Queryable<Student> var s3 = db.Queryable<Student>().Select(it => new { newid = it.Id }).ToList();
().Select(it => new { id = it.Id, w = new { x = it } }).ToList(); var s4 = db.Queryable<Student>().Select(it => new { newid = it.Id, obj = it }).ToList();
var s3 = db.Queryable<Student> var s5 = db.Queryable<Student>().Select(it => new ViewModelStudent2 { Student = it, Name = it.Name }).ToList();
().Select(it => new { newid = it.Id }).ToList(); ```
var s4 = db.Queryable<Student>
().Select(it => new { newid = it.Id, obj = it }).ToList();
var s5 = db.Queryable<Student>
().Select(it => new ViewModelStudent2 { Student = it, Name = it.Name }).ToList();
```
### 1.7 Join Sql ### 1.7 Join Sql
```c ```c
var join3 = db.Queryable("Student", "st") var join3 = db.Queryable("Student", "st")
.AddJoinInfo("School", "sh", "sh.id=st.schoolid") .AddJoinInfo("School", "sh", "sh.id=st.schoolid")
.Where("st.id>@id") .Where("st.id>@id")
.AddParameters(new { id = 1 }) .AddParameters(new { id = 1 })
@@ -164,134 +139,124 @@ var getAll = db.Queryable<Student>
### 1.8 ADO.NET ### 1.8 ADO.NET
```c ```c
var db = GetInstance(); var db = GetInstance();
var t1= db.Ado.SqlQuery<string> var t1= db.Ado.SqlQuery<string>("select 'a'");
("select 'a'"); var t2 = db.Ado.GetInt("select 1");
var t2 = db.Ado.GetInt("select 1"); var t3 = db.Ado.GetDataTable("select 1 as id");
var t3 = db.Ado.GetDataTable("select 1 as id"); //more
//more //db.Ado.GetXXX...
//db.Ado.GetXXX...
``` ```
### 1.9 Where ### 1.9 Where
```c
var list = db.Queryable<Student, School>((st, sc) => new object[] {
JoinType.Left,st.SchoolId==sc.Id
})
.Where((st,sc)=> sc.Id == 1)
.Where((st,sc) => st.Id == 1)
.Where((st, sc) => st.Id == 1 && sc.Id == 2).ToList();
//SELECT [st].[Id],[st].[SchoolId],[st].[Name],[st].[CreateTime] FROM [Student] st
//Left JOIN School sc ON ( [st].[SchoolId] = [sc].[Id] )
//WHERE ( [sc].[Id] = @Id0 ) AND ( [st].[Id] = @Id1 ) AND (( [st].[Id] = @Id2 ) AND ( [sc].[Id] = @Id3 ))
//Where If
string name = null;
string name2 = "sunkaixuan";
var list2 = db.Queryable<Student>()
.WhereIF(!string.IsNullOrEmpty(name), it => it.Name == name)
.WhereIF(!string.IsNullOrEmpty(name2), it => it.Name == name2).ToList();
```
## 2. Insert
```c ```c
var list = db.Queryable<Student, School> var insertObj = new Student() { Name = "jack", CreateTime = Convert.ToDateTime("2010-1-1") ,SchoolId=1};
((st, sc) => new object[] {
JoinType.Left,st.SchoolId==sc.Id
})
.Where((st,sc)=> sc.Id == 1)
.Where((st,sc) => st.Id == 1)
.Where((st, sc) => st.Id == 1 && sc.Id == 2).ToList();
//SELECT [st].[Id],[st].[SchoolId],[st].[Name],[st].[CreateTime] FROM [Student] st //Insert reutrn Insert Count
//Left JOIN School sc ON ( [st].[SchoolId] = [sc].[Id] ) var t2 = db.Insertable(insertObj).ExecuteCommand();
//WHERE ( [sc].[Id] = @Id0 ) AND ( [st].[Id] = @Id1 ) AND (( [st].[Id] = @Id2 ) AND ( [sc].[Id] = @Id3 ))
//Where If //Insert reutrn Identity Value
string name = null; var t3 = db.Insertable(insertObj).ExecuteReutrnIdentity();
string name2 = "sunkaixuan";
var list2 = db.Queryable<Student>
()
.WhereIF(!string.IsNullOrEmpty(name), it => it.Name == name)
.WhereIF(!string.IsNullOrEmpty(name2), it => it.Name == name2).ToList();
```
## 2. Insert //Only insert Name
```c var t4 = db.Insertable(insertObj).InsertColumns(it => new { it.Name,it.SchoolId }).ExecuteReutrnIdentity();
var insertObj = new Student() { Name = "jack", CreateTime = Convert.ToDateTime("2010-1-1") ,SchoolId=1};
//Insert reutrn Insert Count
var t2 = db.Insertable(insertObj).ExecuteCommand();
//Insert reutrn Identity Value
var t3 = db.Insertable(insertObj).ExecuteReutrnIdentity();
//Only insert Name //Ignore TestId
var t4 = db.Insertable(insertObj).InsertColumns(it => new { it.Name,it.SchoolId }).ExecuteReutrnIdentity(); var t5 = db.Insertable(insertObj).IgnoreColumns(it => new { it.Name, it.TestId }).ExecuteReutrnIdentity();
//Ignore TestId //Ignore TestId
var t5 = db.Insertable(insertObj).IgnoreColumns(it => new { it.Name, it.TestId }).ExecuteReutrnIdentity(); var t6 = db.Insertable(insertObj).IgnoreColumns(it => it == "Name" || it == "TestId").ExecuteReutrnIdentity();
//Ignore TestId //Use Lock
var t6 = db.Insertable(insertObj).IgnoreColumns(it => it == "Name" || it == "TestId").ExecuteReutrnIdentity(); var t8 = db.Insertable(insertObj).With(SqlWith.UpdLock).ExecuteCommand();
//Use Lock var insertObj2 = new Student() { Name = null, CreateTime = Convert.ToDateTime("2010-1-1") };
var t8 = db.Insertable(insertObj).With(SqlWith.UpdLock).ExecuteCommand(); var t9 = db.Insertable(insertObj2).Where(true/* Is insert null */, true/*off identity*/).ExecuteCommand();
//Insert List<T>
var insertObj2 = new Student() { Name = null, CreateTime = Convert.ToDateTime("2010-1-1") }; var insertObjs = new List<Student>();
var t9 = db.Insertable(insertObj2).Where(true/* Is insert null */, true/*off identity*/).ExecuteCommand(); for (int i = 0; i < 1000; i++)
{
//Insert List<T>
var insertObjs = new List<Student>
();
for (int i = 0; i < 1000; i++)
{
insertObjs.Add(new Student() { Name = "name" + i }); insertObjs.Add(new Student() { Name = "name" + i });
} }
var s9 = db.Insertable(insertObjs.ToArray()).InsertColumns(it => new { it.Name }).ExecuteCommand(); var s9 = db.Insertable(insertObjs.ToArray()).InsertColumns(it => new { it.Name }).ExecuteCommand();
``` ```
## 3. Delete ## 3. Delete
```c ```c
var t1 = db.Deleteable<Student> var t1 = db.Deleteable<Student>().Where(new Student() { Id = 1 }).ExecuteCommand();
().Where(new Student() { Id = 1 }).ExecuteCommand();
//use lock //use lock
var t2 = db.Deleteable<Student> var t2 = db.Deleteable<Student>().With(SqlWith.RowLock).ExecuteCommand();
().With(SqlWith.RowLock).ExecuteCommand();
//by primary key //by primary key
var t3 = db.Deleteable<Student> var t3 = db.Deleteable<Student>().In(1).ExecuteCommand();
().In(1).ExecuteCommand();
//by primary key array //by primary key array
var t4 = db.Deleteable<Student> var t4 = db.Deleteable<Student>().In(new int[] { 1, 2 }).ExecuteCommand();
().In(new int[] { 1, 2 }).ExecuteCommand();
//by expression //by expression
var t5 = db.Deleteable<Student> var t5 = db.Deleteable<Student>().Where(it => it.Id == 1).ExecuteCommand();
().Where(it => it.Id == 1).ExecuteCommand();
``` ```
## 4. Update ## 4. Update
```c ```c
//update reutrn Update Count //update reutrn Update Count
var t1= db.Updateable(updateObj).ExecuteCommand(); var t1= db.Updateable(updateObj).ExecuteCommand();
//Only update Name //Only update Name
var t3 = db.Updateable(updateObj).UpdateColumns(it => new { it.Name }).ExecuteCommand(); var t3 = db.Updateable(updateObj).UpdateColumns(it => new { it.Name }).ExecuteCommand();
//Ignore Name and TestId //Ignore Name and TestId
var t4 = db.Updateable(updateObj).IgnoreColumns(it => new { it.Name, it.TestId }).ExecuteCommand(); var t4 = db.Updateable(updateObj).IgnoreColumns(it => new { it.Name, it.TestId }).ExecuteCommand();
//Ignore Name and TestId //Ignore Name and TestId
var t5 = db.Updateable(updateObj).IgnoreColumns(it => it == "Name" || it == "TestId").With(SqlWith.UpdLock).ExecuteCommand(); var t5 = db.Updateable(updateObj).IgnoreColumns(it => it == "Name" || it == "TestId").With(SqlWith.UpdLock).ExecuteCommand();
//Use Lock //Use Lock
var t6 = db.Updateable(updateObj).With(SqlWith.UpdLock).ExecuteCommand(); var t6 = db.Updateable(updateObj).With(SqlWith.UpdLock).ExecuteCommand();
//update List<T> //update List<T>
var t7 = db.Updateable(updateObjs).ExecuteCommand(); var t7 = db.Updateable(updateObjs).ExecuteCommand();
//Re Set Value //Re Set Value
var t8 = db.Updateable(updateObj) var t8 = db.Updateable(updateObj)
.ReSetValue(it => it.Name == (it.Name + 1)).ExecuteCommand(); .ReSetValue(it => it.Name == (it.Name + 1)).ExecuteCommand();
//Where By Expression //Where By Expression
var t9 = db.Updateable(updateObj).Where(it => it.Id == 1).ExecuteCommand(); var t9 = db.Updateable(updateObj).Where(it => it.Id == 1).ExecuteCommand();
//Update By Expression Where By Expression //Update By Expression Where By Expression
var t10 = db.Updateable<Student> var t10 = db.Updateable<Student>()
()
.UpdateColumns(it => new Student() { Name="a",CreateTime=DateTime.Now }) .UpdateColumns(it => new Student() { Name="a",CreateTime=DateTime.Now })
.Where(it => it.Id == 11).ExecuteCommand(); .Where(it => it.Id == 11).ExecuteCommand();
``` ```
@@ -301,33 +266,32 @@ var getAll = db.Queryable<Student>
AS>Add>Attribute AS>Add>Attribute
### 5.1 Add ### 5.1 Add
```c ```c
db.MappingTables.Add() db.MappingTables.Add()
db.MappingColumns.Add() db.MappingColumns.Add()
db.IgnoreColumns.Add() db.IgnoreColumns.Add()
``` ```
### 5.2 AS ### 5.2 AS
```c ```c
db.Queryable<T> db.Queryable<T>().As("tableName").ToList();
().As("tableName").ToList();
``` ```
### 5.3 Attribute ### 5.3 Attribute
```c ```c
[SugarColumn(IsIgnore=true)] [SugarColumn(IsIgnore=true)]
public int TestId { get; set; } public int TestId { get; set; }
``` ```
## 6. Use Tran ## 6. Use Tran
```c ```c
//1. no result //1. no result
var result = db.UseTran(() => var result = db.UseTran(() =>
{ {
db.Ado.ExecuteCommand("delete student"); db.Ado.ExecuteCommand("delete student");
}); });
//2 has result //2 has result
var result2 = db.UseTran<List<Student>>(() => var result2 = db.UseTran<List<Student>>(() =>
{ {
return db.Queryable<Student>().ToList(); return db.Queryable<Student>().ToList();
}); });
@@ -435,3 +399,4 @@ var db = GetInstance();
}) })
.CreateClassFile("c:\\Demo\\6"); .CreateClassFile("c:\\Demo\\6");
} }
```